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. There are multiple types of these agents:
Each JetBrains-hosted agent comes with a set of preinstalled software.
Software preinstalled on Windows agents:
|JDK||11.0.10_9, 8.272.10.3, 22.214.171.124.1|
|Ruby||126.96.36.199, 188.8.131.52, 184.108.40.206, 220.127.116.11|
Software preinstalled on Ubuntu 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.
Build agents require 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.
TeamCity Agent is tested under the following operating systems:
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)
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:
Safari under macOS
Other .NET runners:
|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|
|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:
|2.2.10, 2.4.x, 2.5.x, 2.6.x, 3.0.x|
|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
|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|
Other VCSs can be supported in TeamCity via external plugins.
VCS Support on Agent
Labeling Build Sources
Azure DevOps Server, Team Foundation Server
VCS Hosting Services
|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:
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
(supported only for VCS integrations bundled with JetBrains IDEs)
Unity, by the means of the Unity Support plugin (bundled in TeamCity Cloud and can be installed on-demand in TeamCity On-Premises)