TeamCity
 
You are viewing the documentation for an earlier version of TeamCity.

Project and Agent Level Build Parameters

Last modified: 20 April 2023

In addition to defining Configuring Build Parameters in Build Configuration settings, you can define build parameters 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.

You can also define parameters for only those project's build configurations that use the same VCS root. To do that you need to create a text file named teamcity.default.properties, and check it into the VCS root. Ensure the file appears directly in the build working directory by specifying appropriate Configuring VCS Settings. The name and path to the file can be customized via the teamcity.default.properties property of a build configuration. Properties defined this way are not visible in the TeamCity web UI, but are passed directly to the build process.

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

See also:

Administrator's Guide: Configuring Build Parameters | Defining and Using Build Parameters in Build Configuration | Predefined Build Parameters