In a common case, we recommend installing one build agent per physical or virtual machine – this makes the builds’ behavior more predictable and allows avoiding data conflicts between them. However, if you want to run multiple parallel builds on the same machine, you can set up multiple build agents on it.
To do this, install the first build agent as usual. When installing and configuring the following agents on the same machine, remember to:
conf/buildAgent.properties) of each agent:
If you are a TeamCity Cloud user, you can generate a unique agent configuration file automatically: go to Agents, open the Install Build Agents menu in the upper right corner of the screen, and click Use authentication token. Choose the Download config option and enter an agent name (the `name` attribute in the build agent config) to download the entire config file. Place it as the `buildAgent.properties` file in the build agent directory. Revise it as described above.
This Help article describes the installation process in more detail and contains important notes for Windows and macOS machines.