TeamCity 2018.x Documentation

[Documentation for Previous Versions]


You are viewing the documentation of TeamCity 2018.x, which is not the most recently released version of TeamCity.
View this page in the latest documentation or refer to the [listing] to choose the documentation corresponding to your TeamCity version.


Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


  • the user must be able to run the shutdown command (for the agent machine reboot functionality and the machine shutdown functionality when running in a cloud environment)
  • when using systemd, it shoul dnot should not kill the processes on the main proces process exit (use RemainAfterExit=yes)


To run agent automatically on the machine boot under Linux, configure daemon process with the start command to start it and stop command to stop it.

For systemd, check see the example confiuration configuration file:


Description=TeamCity Build Agent


ExecStart=/home/teamcityagent/agent/bin/ start
ExecStop=-/home/teamcityagent/agent/bin/ stop

# Support agent upgrade as the main process starts a child and exits then
# Support agent upgrade as the main process gets SIGTERM during upgrade and that maps to exit code 143
SuccessExitStatus=0 143



For init.d, refer to an example procedure: