Installation
If you are upgrading your existing TeamCity installation, please refer to Upgrade.
Check the System Requirements
Before you install TeamCity, please familiariaze yourself with Supported Platforms and Environments. Additionally, read the hardware requirements for TeamCity. However, note that these requirements differ significantly depending on the server load and the number of builds run.
Select TeamCity Installation Package
The TeamCity installation package is identical for both Professional and Enterprise Editions and is available on the http://www.jetbrains.com/teamcity/download/ page. The following options are available:
Target | Option | Note |
|---|---|---|
Windows | TeamCity<version number>.exe | Executable Windows installer bundled with Tomcat and Java 1.8 JRE. |
Linux, macOS | 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) |
Linux, Windows | Docker | Official JetBrains TeamCity server image |
Install TeamCity
Follow the installation instructions:
Installing TeamCity bundled with Tomcat servlet container (Linux, Mac OS X, Windows)
Installing TeamCity from a Docker image
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 setup additional build agents, follow the instructions.