Supported Platforms and Environments

Edit page
Last modified: 26 April 2022

This page covers software-related environments TeamCity works with. For hardware-related notes, see this section.

Operating Systems

TeamCity Server

TeamCity Server is a web application that runs within a capable J2EE servlet container. It requires a Java SE JRE installation to run. See notes on how to install Java on a TeamCity server.

Supported Java Versions

Supported Java versions: OpenJDK and Oracle Java 8 (8u16 or later) and 11 (32 or 64 bit). Using 64-bit Java is recommended.
The TeamCity server Windows installer and server Docker images come bundled with Amazon Corretto 64-bit Java 11.
For Apple M1 systems, consider using a different version of Java 11, like Azul OpenJDK.

warning

Java 8 support will be discontinued since TeamCity Server 2022.04 (to be released in April 2022). If you use a non-bundled version of Java 8, we highly recommend that you migrate your server to Java 11 until this release.
Note that TeamCity is not currently compatible with Java 17, which makes Java 11 the only version planned for support in TeamCity Server 2022.04.

Supported Platforms

tip

The core features of TeamCity Server are platform-independent. See considerations on choosing the server platform.

Generally, all the recent versions of Windows, Linux, and macOS are supported. If you find any compatibility issues with any of the operating systems, let us know.

TeamCity Server is tested under the following operating systems:

  • Linux (Ubuntu, Debian, RedHat, SUSE, and others)

  • macOS

  • Windows 7/7x64

  • Windows Server 2008, 2012, 2016, 2019, 2022

  • Server Core installation of Windows Server 2016

  • Windows 10 and 11 under the Tomcat 8.5+ web application server

Reportedly works without known issues on:

  • Windows 7+

  • Windows Server 2008 R2

  • Solaris

  • FreeBSD

  • IBM z/OS

  • HP-UX

Windows XP/XP x64 are not supported.

TeamCity Agent

TeamCity Agent is a standalone Java application. It requires a Java SE JRE installation to run. See notes on how to configure Java on agents.

Supported Java Versions

Supported Java versions: OpenJDK and Oracle Java 8-11. We recommend using the latest available version of JDK.
The TeamCity agent Windows installer comes bundled with Amazon Corretto 64-bit Java 11.
For Apple M1 systems, consider using a different version of Java 11, like Azul OpenJDK.

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

  • 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

C# Script

.NET 6.0

.NET 6.0 installed on the build agent, or can be run inside a Docker container with .NET 6.0

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

Kotlin Script

Node.js

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. See Perforce compatibility issues.

Azure DevOps

2005, 2008, 2010, 2012, 2013, 2015, 2017

Mercurial

A Mercurial "hg" client v1.5.2+ installed on the server

CVS

Borland StarTeam

6 or later

A StarTeam client application 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

CVS

Labeling Build Sources

  • Git

  • Subversion

  • Perforce

  • Azure DevOps

  • Mercurial

  • CVS

  • Borland StarTeam

Remote Run

  • Git

  • Mercurial

Feature Branches

  • Git

  • Mercurial

VCS Hosting Services

Cloud Platforms

The following cloud platforms can be used to run build agents:

Available as non-bundled plugins:

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

See also additional requirements.

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 2019.3.x — 2021.1 (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)

  • CVS

  • 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, 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

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.

Databases

Database

Supported versions

HSQLDB

(The internal HSQLDB database can be used for evaluation purposes only.)

2.3.2

MySQL

5.7.34 or later

Microsoft SQL Server

2012 or later (including Express editions), SQL Azure

PostgreSQL

9.6 or later

Oracle

10g or later (tested with the driver version 12.1.0.1

Read more details.

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)