It is recommended to use HTTPS for for agent to server communications (check related server configuration notes). If the agents and the server are deployed into a secure environment, agents can be configured to use plain HTTP URL for connections to the server as this reduces transfer overhead. Note that the data travelling through the connection established from an agent to the server includes build settings, repository access credentials and keys, repository sources, build artifacts, build progress messages and build log. In case of using http:// protocol that data can be compromised via "man in the middle attack".
- Make sure a JDK (JRE) 1.8.0_161 or later (Java 6-10 are supported, but 1.8.0_161+ is recommended)is properly installed on the agent computer.
- On the agent computer, make sure the
JAVA_HOMEenvironment variables are set (pointing to the installed JRE or JDK directory respectively).
- In the TeamCity Web UI, navigate to the Agents tab.
- Click the Install Build Agents link and select Zip file distribution to download the archive.
- Unzip the downloaded file into the desired directory.
- Navigate to the
<installation path>\confdirectory, locate the file called
buildAgent.dist.propertiesand rename it to
- Edit the
buildAgent.propertiesfile to specify the TeamCity server URL (usage of https:// is recommended, see the notes) and the name of the agent. Please refer to Build Agent Configuration section for details on agent configuration.
Under Linux, you may need to give execution permissions to the
On Windows you may also want to install the build agent windows service instead of the manual agent startup.