Supported Platforms and Environments
Operating Systems
TeamCity Agent
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.
JetBrains-Hosted Agents
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.
Self-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.
Supported Java Versions
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.
Supported Platforms
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
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 | 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 | ||
.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 |
|---|---|---|
.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:
|
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-13 | Xcode installed on the build agent |
Testing Frameworks
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.
Version Control Systems
VCS Support on Server
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 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 | ||
2005-2015, 2017 | ||
A Mercurial "hg" client v1.5.2+ installed on the agent |
Labeling Build Sources
Git
Subversion
Perforce
Azure DevOps
Mercurial
Remote Run
Git
Mercurial
Feature Branches
Git
Mercurial
VCS Hosting Services
Azure DevOps Services, or formerly Visual Studio Team Services
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 |
|---|---|---|
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
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. |
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)