Skip to end of metadata
Go to start of metadata
You are viewing documentation of TeamCity 6.5.x, which is not the most recent released version of TeamCity. Please refer to the listing to choose another version.

Table of Contents

Configuration settings of the build agent are stored in a configuration file <TeamCity Agent Home>/conf/
The file can also store properties that will be published on the server as Agent properties and can participate in the agent requirements expressions.
Also, all the system and environment properties defined in the file will be passed to every build run on the agent.

The file is a Java properties file.
A quick guide is:

  • use property_name=value<newline> syntax
  • use "#" in the first position of the line for a comment
  • use "/" instead of "\" as the path separator. If you need to include "\" escape it with another "\".
  • whitespaces within a line matter

This is an example of the file:


Please make sure that the file is writable for the build agent process itself. For example the file is updated to store its authorization token that is generated on the server-side.

If "name" property is not specified, the server will generate build agent name automatically. By default, this name would be created from the build agent's host name.

The file can be edited while the agent is running: the agent detects the change and restarts loading the new changes automatically.

See also: