TeamCity On-Premises 2021.2 Help

Install TeamCity Server on Linux or macOS

Download TeamCity Server

Go to the JetBrains website and download the .tar.gz distribution with the "portable" version of the TeamCity server.

Or, you can install it from a Docker image. All the information related to the TeamCity Server Docker images is described on Docker Hub.

Specifics of the .tar.gz distribution:

  • It includes a Tomcat version tested to work fine with the respective version of TeamCity. You can use an alternative Tomcat version, but other combinations are not guaranteed to work correctly.

  • It is possible to configure the installation by changing the startup script and JRE options.

  • It comes bundled with a build agent distribution and a startup script which allows for easy TeamCity server evaluation with one agent.

  • It comes bundled with the devPackage for the TeamCity plugin development.

Install from tar.gz

It is highly recommended running the TeamCity server under a dedicated user account.

To install the TeamCity server, unpack the TeamCity<version number>.tar.gz archive. You can use the tar xfz TeamCity<version number>.tar.gz command under Linux * and WinZip, WinRar, or similar utility under Windows.

Ensure that JRE or JDK are installed and the JAVA_HOME environment variable is pointing to the Java installation directory (see recommended Java versions).

Last modified: 26 April 2022