Supported Platforms and Environments
This page covers software-related environments TeamCity works with. For hardware-related notes, see this section.
Operating Systems
TeamCity Server
TeamCity Server is a web application that runs within a capable J2EE servlet container. It requires a Java SE JRE installation to run. See notes on how to install Java on a TeamCity server.
Supported Java versions: OpenJDK and Oracle Java 8 (8u16 or later) and 11 (32 or 64 bit). Using 64-bit Java is recommended.
The TeamCity server Windows installer and server Docker images come bundled with Amazon Corretto 64-bit Java 11.
For Apple M1 systems, consider using a different version of Java 11, like Azul OpenJDK.
tip
The core features of TeamCity Server are platform-independent. See considerations on choosing the server platform.
Generally, all the recent versions of Windows, Linux, and macOS are supported. If you find any compatibility issues with any of the operating systems, let us know.
TeamCity Server is tested under the following operating systems:
Linux (Ubuntu, Debian, RedHat, SUSE, and others)
macOS
Windows 7/7x64
Windows Server 2008, 2012, 2016, 2019
Server Core installation of Windows Server 2016
Windows 10 under the Tomcat 8.5+ web application server.
Reportedly works without known issues on:
Windows 7+
Windows Server 2008 R2
Solaris
FreeBSD
IBM z/OS
HP-UX
Windows XP/XP x64 are not supported.
TeamCity Agent
TeamCity Agent is a standalone Java application. It requires a Java SE JRE installation to run. See notes on how to configure Java on agents.
Supported Java versions: OpenJDK and Oracle Java 8-11. We recommend using the latest available version of JDK.
The TeamCity agent Windows installer comes bundled with Amazon Corretto 64-bit Java 11.
For Apple M1 systems, consider using a different version of Java 11, like Azul OpenJDK.
TeamCity Agent is tested under the following operating systems:
Linux
macOS
Windows 7/7x64
Windows 10
Windows Server 2003/2008, 2012, 2016, 2019
Server Core installation of Windows Server 2016
Reportedly works on:
Windows XP/XP x64
Windows 2000 (interactive mode only)
Solaris
FreeBSD
IBM z/OS
HP-UX
Browsers
The TeamCity web interface is mostly W3C-compliant, so any modern browser should work well with TeamCity. The recent versions of the following browsers have been specifically tested and reported to work correctly:
Google Chrome
Mozilla Firefox
Safari under macOS
Microsoft Edge
Opera
Build Runners
Java Runners
| Runner | Supported versions | Bundled versions |
|---|---|---|
| 1.6-1.10 | 1.10.10 | |
| 2.0.x, 2.x, 3.x | 2.2.1, 3.0.5, 3.1.1, 3.2.5, 3.3.9, 3.5.4, 3.6.3 | |
| 0.9-rc-1 or later | ||
.NET Runners
We recommend that you use the unified .NET runner to run .NET projects in TeamCity. See its requirements here.
Other .NET runners:
| Runner | Supported versions | Requirements |
|---|---|---|
| Microsoft Build Tools 2013, 2015, 2017, 2019 | .NET Framework or Mono installed on the build agent | |
| 0.85 - 0.91 alpha 2 | .NET Framework or Mono installed on the build agent | |
| A corresponding version of Microsoft Visual Studio installed on the build agent | ||
| FxCop installed on the build agent | ||
Duplicates Finder for C# and VB.NET code based on ReSharper Command Line Tools | Supported languages are C# up to version 4.0 and VB.NET version 8.0 - 10.0 | .NET Framework 4.6.1 or later installed on the build agent |
| .NET Framework 4.6.1 or later installed on the build agent | ||
| .NET installed on the build agent | ||
| NuGet 1.4 or later | Required on the build agent:
|
Other Runners
| Runner | Supported versions | Requirements |
|---|---|---|
| 2.0 or later | Python installed on the build agent | |
| 0.7.3 gem or later | ||
| 1.0 - 5.0 | ||
| 3-12 | Xcode installed on the build agent |
Testing Frameworks
| Framework | Supported versions | Requirements |
|---|---|---|
JUnit | 3.8.1+, 4.x | |
| 2.2.10, 2.4.x, 2.5.x, 2.6.x, 3.0.x | ||
TestNG | 5.3 or later | |
MSTest and VSTest | 8.x-12.x, 14.x, 15.x, 19.x are supported by the .NET runner | A corresponding Microsoft Visual Studio edition or Visual Studio Test Agent installed on the build agent |
| MSpec installed on the build agent |
Read more about the support for testing frameworks in TeamCity.
Version Control Systems
VCS Support on Server
| VCS | Supported versions | Requirements |
|---|---|---|
For automatic | ||
| Server versions 1.4-1.9 or later | ||
A Perforce client installed on the server. See also Perforce compatibility issues. | ||
Azure DevOps Server, or Team Foundation Server | 2005, 2008, 2010, 2012, 2013, 2015, 2017 | |
| A Mercurial "hg" client v1.5.2+ installed on the server | ||
| 6 or later | A StarTeam client application installed on the server |
Other VCSs can be supported in TeamCity via external plugins.
VCS Support on Agent
| VCS | Supported versions | Requirements |
|---|---|---|
| 1.6.4 or later | A Git client installed on the agent | |
| 1.4-1.8 | ||
| A Perforce client installed on the agent | ||
Azure DevOps Server, or Team Foundation Server | 2005-2015, 2017 | |
| A Mercurial "hg" client v1.5.2+ installed on the agent | ||
Labeling Build Sources
Git
Subversion
Perforce
Azure DevOps Server, Team Foundation Server
Mercurial
CVS
Borland StarTeam
Remote Run
Git
Mercurial
Feature Branches
Git
Mercurial
VCS Hosting Services
- GitHub.com / GitHub Enterprise
- GitLab.com / GitLab CE/EE
- Bitbucket Cloud
Azure DevOps Services, or formerly Visual Studio Team Services
Cloud Platforms
The following cloud platforms can be used to run build agents:
Available as non-bundled plugins:
Issue Trackers
| Tracker | Supported versions |
|---|---|
| 1.0 or later | |
| 4.4 or later (all major features also reportedly worked for version 4.2) | |
| 3.0 or later | |
| 0.9-rc-1 or later | |
Azure DevOps Server (formerly Team Foundation Server — supported version 2012 or later), and Azure DevOps Services |
See also additional requirements.
IDE Integration
TeamCity provides productivity plugins for the following IDEs:
| IDE | Supported versions | Requirements |
|---|---|---|
| 3.8, 4.2-4.6 | Eclipse must be run under JDK 1.5+ | |
Compatible with IntelliJ IDEA 15.0.x - 2019.3.x (Ultimate and Community editions); as well as other IDEs based on the same version of the platform, including JetBrains RubyMine 6.3+, JetBrains PyCharm 3.1+, JetBrains PhpStorm/WebStorm 7.1+, AppCode 2.1+. See more information on compatibility. | ||
| 2010, 2012, 2013, 2015, 2017, 2019 | .NET Framework |
Remote Run and Pre-tested Commit
Remote Run and Pre-tested commit functionality is available for the following IDEs and version control systems:
IDE | Supported VCS |
|---|---|
| |
(supported only for VCS integrations bundled with JetBrains IDEs) |
|
|
Code Coverage
IDE | Supported Coverage Tools |
|---|---|
JetBrains dotCover coverage. Requires JetBrains dotCover installed in Microsoft Visual Studio. |
Databases
| Database | Supported versions |
|---|---|
HSQLDB (The internal HSQLDB database can be used for evaluation purposes only.) | 2.3.2 |
MySQL | 5.7.34 or later |
Microsoft SQL Server | 2012 or later (including Express editions), SQL Azure |
PostgreSQL | 9.6 or later |
Oracle | 10g or later (tested with the driver version 12.1.0.1 |
Game Engines
Unity, by the means of the Unity Support plugin (bundled in TeamCity Cloud and can be installed on-demand in TeamCity On-Premises)