TeamCity 8.0 Help

Licensing Policy

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.


There are two editions of TeamCity: Professional and Enterprise.

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 Configuration. 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 Feedback from JetBrains for the maintenance period of the license.

Each TeamCity edition comes bundled with 3 Build Agent. Each additional build agent above the bundled 3 requires a new build agent license key in both editions.

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.

Number of Build Configurations

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

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

Number of Agents

Each TeamCity edition comes bundled with 3 Build Agent. 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 Build Agent in TeamCity. The license keys are not bound to specific agents, they just limit the maximum number of functional 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.

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 Previous Releases Downloads 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.

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

Please note that TeamCity email Feedback covers only the recent TeamCity versions and can be provided only to customers with not expired maintenance period on enterprise 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.

Enterprise Edition License Types

The Enterprise edition requires one of the following types of licenses:

  • Commercial

    • Perpetual — no expiration date

    • 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 TeamCity 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.

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 evaluation);

  • use a TeamCity TeamCity EAP (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.

Last modified: 20 April 2023