You are viewing the documentation of TeamCity 8.x, which is not the most recently released version of TeamCity.
Go to the latest TeamCity 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.


Agent does not connect to the server

Either after initial setup or with "Agent has unregistered (will upgrade)" note in UI.

First, check the three Agents tab in UI ("Unauthorized", "Connected", "Disconnected") to check for the agent status visible by the server.
Wait for several minutes as agent connection can take time, especially in the slow network environments.

To investigate, check the agent logs for possible issues (teamcity-agent.log, launcher.log, upgrade.log).
If that does not bring up anything obvious and the agent environment complies with the requirements, please send us the full set of agent and server logs as well as screenshots of all the above mentioned Agents UI tabs.

Please refer to Common Problems

Logging events