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.

Skip to end of metadata
Go to start of metadata

If you are upgrading your existing TeamCity installation, please refer to Upgrade.

Check System Requirements

Before you install TeamCity, please familiarize yourself with Supported Platforms and Environments
Additionally, read the hardware requirements for TeamCity. Note that these requirements differ significantly depending on the server load and the number of builds run.

Select TeamCity Installation Package

TeamCity installation package is identical for both Professional and Enterprise Editions.

 The TeamCity download page on the official JetBrains site provides the following installation options:





TeamCity<version number>.exe

Executable Windows installer bundled with Tomcat and Java 1.8 JRE.

Linux, macOS, Windows

TeamCity<version number>.tar.gz

Archive for manual installation bundled with Tomcat servlet container

J2EE container

TeamCity<version number>.war

Package for installation into an existing J2EE container (not recommended, use .tar.gz instead)

Docker (Linux, Windows)


Official JetBrains TeamCity server Docker image


Deploy to AzureOfficial template to launch TeamCity on Azure

You can also install TeamCity using

• TeamCity template on Azure Marketplace
Azure Resource Manager template
Google Cloud Deployment Manager template

Install Additional Build Agents

Although the TeamCity server in .exe and .tar.gz distributions is installed with a default build agent that runs on the same machine as the server, this setup may result in degraded TeamCity web UI performance, and if your builds are CPU-intensive, it is recommended to install build agents on separate machines or ensure that there is enough CPU/memory/disk throughput on the server machine.

To set up additional build agents, follow the instructions.

See also: