Rename a TeamCity Build Agent

Question

I have inherited a TeamCity server and I am reviewing the configuration. To make it a little easier, I would like to rename a build agent from a long random name to something a little more easily identifiable.

However, I cannot find any options to change the name in the Agent Summary page.

Has anyone got a way to change the build agent name?

Answer 1

You need to edit the name field in the buildAgent.properties file on the agent itself:

name=change-this-name

Depending on where you installed the TeamCity Agent, on Windows the file may live at C:\TeamCity\buildAgent\conf\buildAgent.properties or on Linux at /home/teamcity/buildagent/conf/buildAgent.properties.