Project and Agent Level Build Parameters

In addition to defining Configuring Build Parameters in Build Configuration settings, you can define them on project or build agent level.

Project Level Build Parameters

TeamCity allows to define build parameters for all of the project's build configurations at one place - Project Settings-> Parameters tab.

Note that if build parameter P is defined in build configuration and a build parameter with the same name exists on project level, the following heuristics applies: Case 1: Project A, Build Configuration from project A. Parameters defined in build configuration have priority over parameters with the same names defined on project level.

Case 2: Project A, Template T from project A, build configuration from project A inherited from template T. Parameters of build configuration have priority over parameters with the same name defined in project A, and project-level parameters have priority over parameters with the same name defined in template.

Case 3: Project A1, Project A2, Template T from project A1, build configuration from project A2 inherited from template T. Parameters of project A2 (the one build configuration belongs to) have priority over parameters with the same names defined in template.

Agent Level Build Parameters agentSpecific

To define agent-specific properties edit the Build Agent's buildAgent.properties file (<agent home>/conf/buildAgent.properties). Refer to the Predefined Build Parameters page for more information.

When defining system properties and environment variables in teamcity.default.properties or buildAgent.properties file use the following format:

[env|system].<property_name>=<property_value>

For example: env.CATALINA_HOME=C:\tomcat_6.0.13