Supported Platforms and Environments
TeamCity Agent is a standalone Java application. TeamCity Cloud supports two types of agents:
Hosted by JetBrains
Hosted by a customer
You can combine agents of both types in your installation. Read more information on licensing these agents in Subscription and Licensing.
These agents are automatically maintained by JetBrains and don't require to be installed or configured by a customer. To learn more about available agent types and software installed on them, refer to this article: JetBrains-hosted Agents.
You can install a build agent locally on your machine, similarly to how you would do it in TeamCity On-Premises, and connect it to the TeamCity Cloud instance. Note that you need to acquire a concurrent build slot for each self-hosted agent.
Since agents are Java applications, you need to install Java SE JRE on machines that will run self-hosted agents.
Supported Java versions: OpenJDK and Oracle Java 8 - 21. We recommend using the latest available version of JDK. See this article for more information: Configure Java for Agent.
note
Note that Java versions specified in this section are requirements to run the agent itself. Builds can utilize other versions installed on agent machines (for example, JDK 19).
TeamCity Agent is tested under the following operating systems:
Linux
macOS
Windows 7/7x64
Windows 10
Windows Server 2003/2008, 2012, 2016, 2019, 2022
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
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
Runner | Supported versions | Bundled versions |
|---|---|---|
1.6-1.10 | 1.10.10 | |
2.0.x, 2.x, 3.x | Version 3.9.6 is downloaded and installed after TeamCity server first starts. Versions 2.2.1, 3.0.5, 3.1.1, 3.2.5, 3.3.9, 3.5.4, 3.6.3, 3.8.6 are additionally installed if required by build configurations. | |
0.9-rc-1 or later | ||
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 |
|---|---|---|
.NET 6.0 or later | .NET 6.0 or later installed on the build agent, or can be run inside a Docker container with .NET 6.0 or later | |
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:
|
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-13 | Xcode installed on the build agent |
Framework | Supported versions | Requirements |
|---|---|---|
JUnit | 3.8.1+, 4.x, 5.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.
VCS | Supported versions | Requirements |
|---|---|---|
For automatic | ||
Server versions 1.4-1.9 or later | ||
A Perforce Helix Core client installed on the server (2017.1+ versions are supported). | ||
2005, 2008, 2010, 2012, 2013, 2015, 2017 | ||
A Mercurial "hg" client v1.5.2+ installed on the server |
Other VCSs can be supported in TeamCity via external plugins.
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 | ||
2005-2015, 2017 | ||
A Mercurial "hg" client v1.5.2+ installed on the agent |
Git
Subversion
Perforce
Azure DevOps
Mercurial
Git
Mercurial
Git
Mercurial
Azure DevOps Services, or formerly Visual Studio Team Services
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.
TeamCity provides productivity plugins for the following IDEs:
IDE | Supported versions | Requirements |
|---|---|---|
Compatible with IntelliJ IDEA 2019.3 - 2021.2.3 (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 functionality is available for the following IDEs and version control systems:
IDE | Supported VCS |
|---|---|
(supported only for VCS integrations bundled with JetBrains IDEs) |
|
|
IDE | Supported Coverage Tools |
|---|---|
JetBrains dotCover coverage. Requires JetBrains dotCover installed in Microsoft Visual Studio. |
Unity, by the means of the Unity Support plugin (bundled in TeamCity Cloud and can be installed on-demand in TeamCity On-Premises)