TeamCity Maintenance Mode

Last modified: 03 March 2021

If you see the TeamCity Maintenance page on the TeamCity startup, it means this TeamCity instance requires technical maintenance before it can start. In most cases, this page appears if the data format expected by the TeamCity installation does not correspond to the data format in the Data Directory or the database; for example, during upgrade TeamCity will display this page before converting the data to a newer format.

For security reasons, it is to be performed by a system administrator who has administrative access to the environment where the TeamCity server is installed. If you do not have access to the computer where TeamCity is installed, inform your system administrator that TeamCity requires technical maintenance.

If you are a TeamCity system administrator, confirm it by entering the authentication token into the corresponding field on this page. This token can be found in the teamcity-server.log file under <TeamCity home>/logs.

After you have provided this token, you can review the details on what kind of maintenance is required. The need in technical maintenance may be caused by one of the following factors: