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. There are multiple types of these agents:

Instance Type	Hardware
Linux (small)	CPU: 2 vCPU (Intel Xeon (Cascade Lake)) RAM: 4 Gb ram SSD: 20 Gb
Linux (medium)	CPU: 4 vCPU (Intel Xeon (Cascade Lake)) RAM: 8 Gb ram SSD: 20 Gb
Windows (medium)	CPU: 4 vCPU (Intel Xeon (Cascade Lake)) RAM: 8 Gb ram SSD: 20 Gb

Each JetBrains-hosted agent comes with a set of preinstalled software.

Software preinstalled on Windows agents:

Software	Version
Unity	2020.3.1
JDK	11.0.11_9
.NET
Git	2.31.1
kubectl	1.21.1
AWS CLI	2.2.5
WiX Toolset	3.11.2
NUnit	3.12.0
7-Zip	19.0
Yarn	1.22.5
Docker	20.10.4
Docker Compose	1.29.2
Gradle	6.9
CMake	3.20.2
Ruby	3.0.0.1
RTools
Node.js	v14.17.0

Software preinstalled on Ubuntu agents:

Software	Version
Git	2.32.0
Git LFS	git-lfs/2.13.3
Zsh	5.8
Chromium	92.0.4515.131
Firefox	snap
Google Chrome	92.0.4515.131
ChromeDriver	92.0.4515.107
Docker	20.10.8
Docker CLI	20.10.8
Docker Compose	1.28.0
AWS CLI	aws-cli/1.18.69
kubectl	GitVersion:"v1.22.0",
Azure CLI	2.27.0
Google Cloud SDK	351.0.0
JDK 8	java-1.8.0-amazon-corretto
JDK 15	java-15-amazon-corretto
JDK 16	java-16-amazon-corretto
JDK 11	java-11-amazon-corretto
Android SDK	7302050
Perforce
Mercurial	5.3.1
SVN	1.13.0
Helm	v3.5.4+g1b5edb6
Yarn
Ant	1.10.7
Gradle	6.9
CMake	3.20.2
Apache Maven	3.6.3
PowerShell	7.1.3
R	3.6.3
Groovy	3.0.8
RVM	1.29.12-next
rustup	1.24.3
Cargo	1.54.0
rustc	1.54.0
Go	1.16.4
NVM	0.33.11
Node.js	14.5
Python	3.8.10
Python 2	2.7.18
Python 3	3.9.6
pip3	21.2.3
pip	21.2.3
Ansible	2.9.6

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.

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:

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
Ant	1.6-1.10	1.10.10
Maven	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
IntelliJ IDEA Project
Gradle	0.9-rc-1 or later
Java Inspections
Java Duplicates

.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
MSBuild	Microsoft Build Tools 2013, 2015, 2017, 2019	.NET Framework or Mono installed on the build agent
NAnt	0.85 - 0.91 alpha 2	.NET Framework or Mono installed on the build agent
Microsoft Visual Studio Solutions		A corresponding version of Microsoft Visual Studio installed on the build agent
FxCop		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
Inspections for .NET based on ReSharper Command Line Tools		.NET Framework 4.6.1 or later installed on the build agent
.NET Process Runner		.NET installed on the build agent
NuGet	NuGet 1.4 or later	Required on the build agent: NuGet.exe command-line tool on Windows: NuGet versions prior to 2.8.6 — .NET Framework 4.0 or later; NuGet 2.8.6 or later — .NET Framework 4.5 on Linux and macOS: Mono 4.4.2 or later and NuGet CLI 3.2 or later

Other Runners

Runner	Supported versions	Requirements
Command Line
Python	2.0 or later	Python installed on the build agent
Rake	0.7.3 gem or later
PowerShell	1.0 - 5.0
Xcode	3-12	Xcode installed on the build agent

Testing Frameworks

Framework	Supported versions	Requirements
JUnit	3.8.1+, 4.x
NUnit	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		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
Git		For automatic `git gc` support and maintenance of Git clones, requires a Git client installed on the server
Subversion	Server versions 1.4-1.9 or later
Perforce		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
Mercurial		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
Git	1.6.4 or later	A Git client installed on the agent
Subversion	1.4-1.8
Perforce		A Perforce client installed on the agent
Azure DevOps Server, or Team Foundation Server	2005-2015, 2017
Mercurial		A Mercurial "hg" client v1.5.2+ installed on the agent

Labeling Build Sources

Git
Subversion
Perforce
Azure DevOps Server, Team Foundation Server
Mercurial

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

Issue Trackers

Tracker	Supported versions
JetBrains YouTrack	1.0 or later
Atlassian Jira	4.4 or later (all major features also reportedly worked for version 4.2)
Bugzilla	3.0 or later
GitHub	0.9-rc-1 or later
Bitbucket Cloud
Azure DevOps Server (formerly Team Foundation Server — supported version 2012 or later), and Azure DevOps Services

IDE Integration

TeamCity provides productivity plugins for the following IDEs:

IDE	Supported versions	Requirements
Eclipse	3.8, 4.2-4.6	Eclipse must be run under JDK 1.5+
IntelliJ Platform Plugin	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.
Microsoft Visual Studio	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
Eclipse	Subversion 1.7-1.8 via Subclipse and Subversive Eclipse integration plugins or SvnKit. Subversion 1.4-1.7 via Subclipse and Subversive Eclipse integration plugins. Perforce (P4WSAD 2009.2 - 2010.1, P4Eclipse 2010.1 - 2015.1) Git (the EGit 2.0+ Eclipse integration plugin) ClearCase (the client software is required), integrated via an additional plugin Read more details.
IntelliJ IDEA Platform (supported only for VCS integrations bundled with JetBrains IDEs)	Subversion Perforce Git (remote run only) Azure DevOps Server, or formerly Team Foundation Server
Microsoft Visual Studio	Subversion 1.4-1.11 (the command-line client is required); note that 1.10-1.11 is supported since ReSharper 2018.3. Azure DevOps Server (formerly Team Foundation Server — supported version 2005 or later). Installed Team Explorer is required. Perforce 2008.2 or later (the command-line client is required).

IDE

Supported VCS

Eclipse

Subversion 1.7-1.8 via Subclipse and Subversive Eclipse integration plugins or SvnKit.
Subversion 1.4-1.7 via Subclipse and Subversive Eclipse integration plugins.
Perforce (P4WSAD 2009.2 - 2010.1, P4Eclipse 2010.1 - 2015.1)
Git (the EGit 2.0+ Eclipse integration plugin)
ClearCase (the client software is required), integrated via an additional plugin

Code Coverage

IDE	Supported Coverage Tools
Eclipse	IDEA and EMMA code coverage
IntelliJ IDEA Platform	IDEA, EMMA, and JaCoCo code coverage
Microsoft Visual Studio	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)

Last modified: 19 October 2021