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 SSD storage (for running builds): 50 GB Root EBS volume: 100 GB
Linux (Medium)	CPU: 4 vCPU (Intel Xeon - Cascade Lake) RAM: 8 GB SSD storage (for running builds): 100 GB Root EBS volume: 100 GB
Linux (Large)	CPU: 8 vCPU (Intel Xeon - Cascade Lake) RAM: 16 GB SSD storage (for running builds): 200 GB Root EBS volume: 100 GB
Linux (XLarge)	CPU: 16 vCPU (Intel Xeon - Cascade Lake) RAM: 32 GB SSD storage (for running builds): 400 GB Root EBS volume: 100 GB
Windows (Small)	CPU: 2 vCPU (Intel Xeon - Cascade Lake) RAM: 8 GB SSD storage (for running builds): 100 GB Root EBS volume: 100 GB
Windows (Medium)	CPU: 4 vCPU (Intel Xeon - Cascade Lake) RAM: 8 GB SSD storage (for running builds): 100 GB Root EBS volume: 100 GB
macOS (Medium)	CPU: 6 vCPU (Intel i7) RAM: 15 GB Storage (for preinstalled software and running builds): 150 GB

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

Software preinstalled on Windows agents:

Software	Version
PowerShell	7.3.8
msys2	20230718.0.0
Ruby	3.2.2
AWS CLI	2.8.3
7-Zip	22.1
Unity Hub	3.5.2.0
Unity	2022.3.2.18231
JDK	11
.NET	7.0.102
kubectl	1.25.3
NUnit	3.16.3
WiX Toolset	3.11.2
Git	2.41.0.1
Perforce	2022.1
Mercurial	1.0.0.1
SVN	1.14.2.64502
RTools
Node.js	v18.18.2
Yarn	1.22.19
vcpkg	2023-09-15-ac02a9f660977426b8ec6392919fbb1d51b10998
Docker	20.10.9
Docker Compose	1.29.2
Bazelisk	1.17.0
Bazel	1.0.0.0
Gradle	7.5.1
CMake	3.24.2

Software preinstalled on Ubuntu agents:

Software	Version
Git	2.42.0
Git LFS	3.4.0
Zsh	5.8
Chromium	117.0.5938.92
Firefox
Google Chrome	117.0.5938.149
ChromeDriver	114.0.5735.90
Docker	24.0.6
Docker CLI	24.0.6
Docker Compose	1.29.2
AWS CLI	2.13.24
kubectl
Azure CLI	2.53.0
Google Cloud SDK	449.0.0
JDK 8	java-1.8.0-amazon-corretto
JDK 17	java-17-amazon-corretto
JDK 21	java-21-amazon-corretto
JDK 11	java-11-amazon-corretto
Android SDK	8512546
Perforce	2023.1 (2468153)
Mercurial	5.3.1
SVN	1.13.0
Helm	v3.10.0+gce66412
Yarn
Bazelisk	6.3.2
Bazel	6.3.2
Ant	1.10.7
Gradle	7.5.1
CMake	3.25.2
Apache Maven	3.6.3
Python	3.8.10
Python 2	2.7.18
Python 3	3.9.18
pip3	23.2.1
pip	23.2.1
PowerShell	7.3.7
R	3.6.3
Groovy	4.0.5
RVM	1.29.12-next
Python Virtualenv	20.24.5
Python Pipenv	2023.10.3
Python Poetry	1.6.1)
rustup	1.26.0
Cargo	1.72.1
rustc	1.72.1
Go	1.19.1
NVM	0.39.2
Node.js	16.18
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.

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 - 17. 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
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, 3.8.6
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
C# Script	.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
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-13	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 Helix Core client installed on the server (2017.1+ versions are supported).
Azure DevOps	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	2005-2015, 2017
Mercurial		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

GitHub.com / GitHub Enterprise
GitLab.com / GitLab CE/EE
Bitbucket (Cloud, Server, Data Center)
Azure DevOps Services, or formerly Visual Studio Team Services
JetBrains Space

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
IntelliJ Platform Plugin	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.
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
IntelliJ IDEA Platform (supported only for VCS integrations bundled with JetBrains IDEs)	Subversion Perforce Git (remote run only) Azure DevOps, 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 (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

IntelliJ IDEA Platform

(supported only for VCS integrations bundled with JetBrains IDEs)

Subversion
Perforce
Git (remote run only)
Azure DevOps, 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 (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).

Code Coverage

IDE	Supported Coverage Tools
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: 07 September 2023