Unable to render embedded object: File (TeamCity48.png) not found.

TeamCity 10.x and 2017.x Documentation


You are viewing the documentation of TeamCity 10.x and 2017.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.


See also a related post: description of a substantial TeamCity setup.

Configuring TeamCity Server for Performance

Here are some recommendations to tweak TeamCity server setup for better performance. The list for production server use is a prerequisite:

  • Regularly review reported Server Health reports (including hidden ones)
  • Use separate reverse proxy server (e.g. NGINX) to handle HTTPS
  • Use separate server for the external database and monitor database performance
  • Make sure clean-up is configured for all the projects with due retention policy, make sure cleanup completely finishes regularly (check Administration / Clean-Up page)
  • Consider moving <TeamCity Data Directory>/system/caches to a separate local drive
  • Regularly archive obsolete projects
  • Regularly review the installed not bundled plugins and remove those not essential for the server functioning
  • Consider using agent-side checkout whenever possible
  • Make sure the build logs are not huge (tens megabytes at most, better less than 10 Mb)
  • If the server is often used by large number of users (e.g. more than 1000), consider reducing UI refresh intervals
  • When regularly exceeding 500 running builds which log a lot of data, consider using Several Nodes Setup

Retrieve Administrator Password