Icon

You are viewing the documentation of TeamCity 9.x, which is not the most recently released version of TeamCity.
View this page in TeamCity 10.x documentation or refer to the listing to choose the documentation corresponding to your TeamCity version.

 
Skip to end of metadata
Go to start of metadata

This page covers:

You can review TeamCity license agreement on the official web site or in the footer of the installed TeamCity server web UI.
New licenses can be purchased via the official web site. If you have any questions on the licensing terms, obtaining or upgrading license key and related, please contact JetBrains sales department.

Licensing Overview

JetBrains offers several licensing options that allow you to scale TeamCity to your needs.
This section illustrates the main differences between the TeamCity server editions and provides general information on the TeamCity Build Agent license.

For detailed information, refer to the sections below.

Professional Server

Enterprise Server

no license key is required,
free

a license key is required,
price options

20 build configurations

unlimited number of build configurations

full access to all product features

free 1-year subscription to upgrades

support via community forum

priority email support

3 build agents included, buy more as necessary

from 3 to 100 build agents included, buy more as necessary

If you need more build agents that are included with your TeamCity server edition, you can purchase additional build agent licenses.

Build Agent License

connects 1 additional build agent

if using Professional edition, adds 10 additional build configurations

a license key is required, price options

Editions

There are two editions of TeamCity: Professional and Enterprise.
The editions are equal in all the features except for the maximum number of build configurations allowed.
The same TeamCity distribution and installation is used for both editions. You can switch to the Enterprise edition by entering the appropriate license key. All the data is preserved when the edition is switched.

The Professional edition does not require any license key and can be used free of charge. The only functional difference from the Enterprise edition is a limitation of the maximum number of build configurations. The limit is 20, and since TeamCity 8.0 it can be extended by 10 with each agent license key added. You can install several servers with Professional license.

The Enterprise edition requires a license key, has no limit on the number of build configurations and entitles you to TeamCity support from JetBrains for the maintenance period of the license.

Each TeamCity edition comes bundled with 3 or more build agents. Each additional build agent above the bundled ones requires a new build agent license key in both editions.

Besides the Professional and Enterprise licenses, there are two more license types:

  • Evaluation — has an expiration date and provides an unlimited number of agents and build configurations. To obtains the evaluation license, please use the link on TeamCity download page. The evaluation license can be obtained only once for each major TeamCity version. A second evaluation license key from the site is not accepted by the same major version of TeamCity server. If you need to extend/repeat the evaluation, please contact our sales department.
    Each EAP (preview, not stable) release of TeamCity comes bundled with a 60-day evaluation license.
  • Open Source — this is a special type of license granted for open source projects, it is time-based, and provides an unlimited number of agents. Refer to the details on the page

The TeamCity Licensing Policy does not impose any limitations on the number of instances for any of the IDE plugins or the Windows Tray Notifiers.

Number of Build Configurations

The Enterprise edition has no limit on the number of build configurations.

The Professional edition allows 20 build configurations per server. Since TeamCity 8.0, each build agent license key gives you 10 more build configurations in Professional edition in addition to one more agent. All build configurations are counted (i.e. including those in archived projects).

Number of Agents

Each TeamCity edition comes bundled with 3 build agents. These 3 agents are bound to the TeamCity server installation and not to the server license key. More build agents can be added by purchasing additional agent license keys.

Generally, a server license key does not include any agent licenses. The agent license keys can be used with either TeamCity edition (Enterprise and Professional). For more information about purchasing agent licenses, refer to the product page.

The number of agent licenses limits the number of agents which can be authorized in TeamCity. The license keys are not bound to specific agents, they just limit the maximum number of functional agents. The licensing makes no difference between local (installed on the TeamCity server machine) and remote agents.
When there are more authorized agents than the agent licenses available, the server stops to start any builds and displays a warning message to all users in the web browser.

Managing Licenses

You can enter new license keys and review the currently used ones (including the license issue date and maintenance period) on the Administration > Licenses page of the TeamCity web UI. By default, only users with the System Administrator role can access the page. Adding or removing licenses on the page is applied immediately.

A single license can only be used on a single running server. If you create a copy of the server and run two servers at the same time, you should ensure each license key is used on a single server only. You can use Evaluation (limited time) license to run a server for testing/non production purposes. The licenses are not bound to specific server instance, machine, etc. The only limitation is that a license cannot be used on several servers at the same time.

When you already own license(s) and buy more licenses, you can request JetBrains sales to make the new licenses co-termed with those already purchased, so that all the licenses have equal maintenance expiration date. The cost of the licenses is then lowered proportionally.
When buying many licenses you are welcome to contact our sales for available volume discounts.

Valid TeamCity Versions

TeamCity licenses are perpetual for the TeamCity versions they cover. This means that you can run a covered TeamCity version with existing licenses for unlimited time and the licenses will stay valid for this TeamCity version.
Each TeamCity license (including Enterprise Server and Agent) has a maintenance period (generally 1 year). The license key is valid with any TeamCity version released within the maintenance period. Licenses valid for the major/minor release (changes in the first two release numbers) is also considered valid for the corresponding bugfix updates (changes in the third release number).

Before you upgrade to a newer TeamCity version, please check the validity of the existing licenses with the new version.
If the new TeamCity server effective release date is not covered by the maintenance period of some of the licenses, the corresponding licenses will not be valid with the TeamCity version and would need an upgrade.


When a new version is available, TeamCity displays a notification in the web UI and warns you if any of your license keys are incompatible with this new version. A notification on the new TeamCity version is also displayed in the Global Configuration Items of the Server Health report, visible to system administrators. System administrators can use the link in the "Some Licenses are incompatible" message to quickly navigate to the Licenses page, where all incompatible licenses will have a warning icon. The information about the license keys installed on your server is secure as it is not sent over the Internet.

Regular upgrades are recommended as new releases contain lots of fixes (and of course new features).

Please note that TeamCity email support covers only the recent TeamCity versions and can be provided only to customers with not expired maintenance period of the enterprise server license.

License Expiration

If an Enterprise license key is removed from the server, or an evaluation license expires, or a TeamCity server is upgraded to a version released out of the maintenance window of the available Enterprise license, TeamCity automatically switches to the Professional mode.

If the number of build configurations or the number of authorized agents exceed the limits imposed by the valid licenses, the server stops to start any builds and displays a warning message to all users in the web browser.

Build Agent Licenses work the same way as the Server Licenses. If you upgrade the server to the version which is not covered by the agent license maintenance window, then this agent license will expire.

Ways to Obtain a License

The following ways to switch your server into the Enterprise mode exist:

  • buy an Enterprise Server license;
  • request a 60-days evaluation license on the download page (see details above);
  • use a TeamCity EAP release (not stable, but comes bundled with a 60-day nonrestrictive license);
  • use TeamCity for open-source projects only and request an open-source license.

Upgrading From Previous Versions

Upgrading from TeamCity 5.x and later

Each license has a maintenance period (typically one year since the purchase date). The license is suitable for any TeamCity version released within the maintenance period. Please check the maintenance period of your licenses before upgrading.

Upgrading from TeamCity 4.x to TeamCity 5.0 and later

Licenses for previous versions of TeamCity needs upgrading, see details at Licensing and Upgrade section on the official site.

Upgrading from TeamCity 3.x to TeamCity 4.0

Owners of TeamCity 3.x Enterprise Server Licenses upgrade to TeamCity 4.x Enterprise Edition free of charge. TeamCity 3.x Build Agent Licenses are compatible with both Professional and Enterprise editions of TeamCity 4.0.

Upgrading from TeamCity 1.x-2.x to TeamCity 4.0

Any TeamCity 1.x-2.x license purchased before December, 05, 2008 can be used as one TeamCity 4.0 Build Agent license for both Professional and Enterprise editions of TeamCity 4.0. Additionally, TeamCity 1.x-2.x customers qualify for one TeamCity Enterprise Server License free of charge. To request your Enterprise Server License, please contact sales department with one of your TeamCity 1.x-2.x licenses.

Upgrading with IntelliJ IDEA 6.0 License Key

Any IntelliJ IDEA 6.0 license purchased between July 12, 2006 and January 15, 2007 can be used as one TeamCity 4.0 Build Agent license. Additionally, IntelliJ IDEA customers with such licenses qualify for one TeamCity Enterprise Server license free of charge.
To check TeamCity upgrade availability for your IntelliJ IDEA licenses and to request your Enterprise Server license, please contact sales department with one of your IntelliJ IDEA licenses purchased within the above period.

See also:

Concepts: Build Agent
Licensing: Licensing & Upgrade