TeamCity 2018.1.3 is released

We have just released TeamCity 2018.1.3, the update containing about 80 fixed issues.
Our UI keeps improving and this version comes with a prettier, faster branch selector:











Among other improvements, we should mention fixes for memory leaks on the server side and on the read-only server, a number of problems in Kotlin DSL as well as some other performance and stability fixes.

We recommend upgrading as this release also addresses a few security problems: the complete list of fixes is available in our release notes.

As usual with our bugfix updates, TeamCity 2018.1.3 has the same data format as all 2018.1.x versions, which provides for easy upgrade/downgrade within these builds.

Remember to check our Upgrade Notes and use one of the upgrade options:

  • easily upgrade from a recent version with our automatic upgrade
  • download the new version from the website or
  • pull the new version of the TeamCity docker image

Your feedback is welcome in our forum or tracker.

Happy building!

Posted in Bugfix, Release | Tagged | Leave a comment

GitHub Pull Requests plugin for TeamCity

The hassle with Pull Requests

These days pull requests is a common technique of accepting changes from third-party contributors. In fact, it proved to be so convenient that some companies started to use it even for their regular development workflows.

It is possible to configure TeamCity to run builds on GitHub pull request branches. One had to provide a VCS root branch specification like refs/pull/*/head for that. However, this configuration is not without its downsides.

For instance, with this configuration, the pull request for TeamCity is just a branch in a Git repository. It means that it is impossible to distinguish pull requests by their target branches. Moreover, it is a known fact that even if a pull request is closed in GitHub, the corresponding branch remains in a Git repository. It is not so uncommon to see repositories with several thousands of pull request-related branches. In TeamCity they clutter the user interface and make the performance worse.

TeamCity does not know who opened the pull request either, so it is not possible to limit the builds of pull requests opened by the organization members only. As a result, if third parties can open pull requests for your repositories, configuring TeamCity to build pull requests imposes a big security risk.

GitHub Pull Requests plugin

The new GitHub Pull Requests plugin is intended to address all the issues described above. As stated in the plugin name, it supports GitHub and GitHub Enterprise only.

The plugin provides a build feature which allows filtering pull requests that you want to build:

The author filter in the build feature configuration settings provides the following options:

  • PRs coming from the members of the same organization only
  • PRs from the members and all external collaborators
  • PRs from everybody.

Once the new build feature is added to a build configuration, TeamCity will provide additional details for the pull request branch on the build overview page:

The plugin is compatible with TeamCity 2018.1.x. You can download it from the plugin repository.

As usual, we will be happy to get your feedback! Our forum and tracker are at your disposal and if you encounter any problems, please share them with us to help us improve.

Posted in Blogroll, Features, FYI | Tagged , , , | 24 Comments

TeamCity on Azure Marketplace

Some time ago we announced TeamCity Azure Resource Manager for TeamCity deployment in Azure cloud. Now we’re glad to provide the TeamCity offer in the Azure Marketplace for streamlined TeamCity setup.

It is also available as a TeamCity download option on the official JetBrains site:


The offer lets you run a JetBrains TeamCity server and a local agent on an Azure Linux VM in Azure.

Today we’ll go over a TeamCity instance setup on Azure, which will save you time and effort of configuration tasks.


You’ll need an Azure subscription and about 10 minutes to set up TeamCity.
Note: Make sure you have a contributor and user access administrator roles on Azure.


Most of the TeamCity installation is automated, all you need to do is perform a few steps:

  1. Log in to the Azure portal.
  2. In your browser, open the TeamCity offer in the Azure Marketplace.
  3. Select GET IT NOW
  4. Review the pricing and terms information, select Continue.
  5. Select Create at the bottom of the page to configure a TeamCity installation.
  6. Configure settings:
    1. In the Basics tab, create a new resource group, in our case teamcity_demo:
    2. Configure Virtual machine settings: provide the username and authentication type. The recommended approach is to use SSH key for that. Password authentication is not recommended due to the known issue with CoreOS metadata service which breaks the startup of the default build agent. The Domain name label, DNS Prefix for the TeamCity server, will be auto-filled for you. If editing it, make sure it is globally unique.
      At this step, you also need to configure and save the subnet settings. Click OK to save the Virtual Machine settings.
    3. On the Additional Settings tab, select the TeamCity installation size and provide a password for the MySQL database of your TeamCity instance.
    4. Review the summary on the next screen. If required, download the template and parameters on your local machine for future use. Go on creating the TeamCity instance by clicking Ok.
  7. Review the privacy policy and if you agree, proceed by using Create. The deployment in progress message appears and you can click on it or the notification icon at the top to review the progress. The Operation Details link can be useful if an error occurs.
  8. Click Refresh. Upon a successful installation you’ll see the TeamCity URL name in the deployment Outputs tab:

That’s it! Now you can use the URL to access your TeamCity instance: you’ll need to accept the license agreement and set up the administrator account credentials.

You are ready to use your TeamCity installation, which includes the server and one local agent. See the TeamCity Quick start guide to configure and run your first build.

You might also want to expand your installation and make it more flexible by performing a couple of additional steps.

Adding Azure agents

Your TeamCity setup includes a TeamCity server and a local agent. You can add more agents to your installation using the cloud profile:

In the TeamCity Web UI, go to the Project Settings | Cloud Profiles and select Azure to create a cloud profile to start TeamCity agents:teamcity-profile

Configure a VM image:

Select teamcity-demo resource group, set container (preview) as the image type, and specify the jetbrains/teamcity-agent docker image. Configure the remaining settings and save them.

Note that specifying the storage account will persist container volumes in Azure, preventing the agent upgrade on each start.


After you finish the setup, it’ll take the agent about 10 min to connect to the TeamCity server: this time is required to start a VM from the created image, then the machine needs to download all the required plugins, etc.

The connected agent will be visible on the agent page:


Configuring artifact storage

By default, TeamCity uses built-in storage for artifacts. To switch to Azure cloud storage, perform the following:

  1. In the TeamCity Web UI, go to the Project Settings | Artifacts Storage tab. The built-in TeamCity artifacts storage is displayed by default and marked as active.
  2. Click Add new storage. Select Azure as the storage type. Optionally, provide a name for your storage.
  3. Supply your storage credentials:
    1. in the Azure portal, go to Storage accounts -> Access keys and copy the storage account name
    2. paste it to the account name in the TeamCity.
    3. Perform the same for the key – any of the two keys available on the portal will work.
  4. Save your settings.
  5. The configured Azure storage will appear on the Artifacts storage page. Make it active using the corresponding link.

Now TeamCity will store build artifacts externally.

Happy building!

Posted in FYI, News & Events, Partner | Tagged | 8 Comments

TeamCity 2018.1.2 is released

We are happy to announce TeamCity 2018.1.2, the bugfix update containing over 100 fixed issues in various areas of TeamCity. The changes are mostly related to

  • Kotlin DSL
  • Performance
  • Security (several new XSS’s were fixed)

Besides, starting from this version TeamCity supports several read-only nodes running simultaneously.

The complete list of fixes is available in our release notes.

Check the Upgrade Notes before you install the new version and do not hesitate to upgrade: version 2018.1.2 has the same data format as all 2018.1.x builds do and makes it possible to upgrade/downgrade between these versions.

TeamCity offers several upgrade options:

Your feedback is welcome in our forum or tracker.

Happy building!

Posted in Bugfix, Features, Release | 10 Comments

New in TeamCity 2018.1: Inherited build steps configuration improvements

There is sometimes a need to define a common build step in a template, so that this step will be executed either before all build configuration steps or after them.

Here’s a simple example. I’m building a lot of typical Maven projects, and for most of the part their build is the same: just run mvn clean package and upload the binaries to the maven repository. However, for some of the builds, I need the additional steps to run in between mvn package and mvn deploy.

In TeamCity, the requirement above can be implemented with the aid of Build Configuration Templates. Starting with version 2018.1, for a given template it is possible to define build steps and then define their placement in respect to build steps defined in a build configuration. The build configuration steps are represented as a placeholder in the Reorder Build Steps dialog. The template steps can be placed before or after this placeholder.


This looks like a neat solution to the problem I described above! :)

Even more: it is possible to override the inherited build steps right in the build configuration. For the rare occasions, it makes sense! For instance, what if for one of the build configurations I want to upload the binaries to some different repository than the one defined in the template? I could just add altDeploymentRepository parameter to the build step – voila!


The build step will be marked as overridden in the list of all steps of the build configuration.

Posted in Blogroll, Features, Tips&Tricks | Tagged , , | 1 Comment

New in TeamCity 2018.1: Enforced settings

Enforcing some rules in a project might be quite useful to keep the things in order. For instance, enforce agent side checkout everywhere, or make sure that all build configurations have some strict execution timeout, or enable build files cleanup (Swabra) for all the builds.

Starting with 2018.1, TeamCity provides the ability to enforce settings for all of the build configurations in a project hierarchy.

To enforce some settings in the project hierarchy, a template with these settings must be created. After that, a system administrator can set this template as the enforced settings template in the project:


To some extent, the enforced settings template works similarly to the default template – i.e., build configurations inherit all of its settings in the project hierarchy. The difference is that these inherited settings cannot be disabled or overridden anyhow.

In addition to that, only system administrator can associate a project with a specific enforced settings template, project administrator permissions are not sufficient. So it makes sense to store the enforcement template in a place that is only editable by a system administrator, for instance – in a Root Project.

On the other hand, the template itself can be edited by a project administrator who can administer the project where the template is defined. If the enforced settings template is specified in a project and another template is assigned as the enforced settings in a subproject, the subproject’s template has the higher priority.

Currently it is not possible to enforce VCS roots, build steps, triggers, dependencies and requirements. Let us know if you see valid use cases when this would be useful.

Posted in Blogroll, Features | Tagged , | Comments Off on New in TeamCity 2018.1: Enforced settings

New in TeamCity 2018.1: Project Level NuGet feed

TeamCity integrates with NuGet package manager and can also serve a NuGet feed. Using TeamCity as a NuGet feed comes handy if you want to publish your NuGet packages to a limited audience – just to your team, for instance.

Before TeamCity version 2018.1, NuGet feed was global for the whole server. And it was only possible for the system administrator to enable the feed.

Having a global feed could lead to a substantial size, delays with packages appearance, etc. TeamCity 2018.1 addresses those issues by allowing to enable a NuGet feed at the project level, which means each project can have a dedicated feed. As a consequence, the project administrator has the authority to enable the feed, which reduces the administrative overhead.


By default, TeamCity no longer adds all .nupkg artifacts to the project feed. To index packages published by selected build configurations only, add the NuGet packages indexer build feature to these build configurations.


Alternatively, to index all .nupkg files published as build artifacts in the project, enable Automatic NuGet Packages Indexing on the NuGet Feed page of the project settings.

Posted in Blogroll, Features | Tagged , | Comments Off on New in TeamCity 2018.1: Project Level NuGet feed

TeamCity 2018.1.1 is here

A month has passed since we published TeamCity 2018.1. During this month we tirelessly processed feedback from you fixing the regressions that we accidentally introduced in 2018.1. We’re very grateful to our users who installed version 2018.1 and reported bugs back to us. Your patience and willingness to improve the product are very much appreciated!

2018.1 indeed broke a few things. For instance, a major problem was found in the NuGet feed implementation, some users experienced problems with the “History” builds appearance after the upgrade, the agent side checkout with Git did not work in some cases, etc.

All these problems and many others have been fixed in the current version, 2018.1.1. This build also brings fixes in Kotlin DSL, memory usage optimizations and a few performance fixes. See the list of all fixed issues in our Release notes.

As usual with bugfix releases, TeamCity 2018.1.1 has the same data format as 2018.1 does, making it easier to upgrade/downgrade between these versions.

If you’re using a recent version of TeamCity, consider using our automatic upgrade. In other cases, you can download the new version from the website or pull the new version of the TeamCity docker image.

Your feedback is welcome in our forum or tracker.

Happy building!

Posted in Bugfix, Release | 2 Comments

Webinar recording and Q&A: What’s New in TeamCity 2018.1

Missed the webinar? No problem – the recording of our July 10 webinar, What’s New in TeamCity 2018.1, is now available.

In this webinar, Anton Arhipov showcases the major features of the latest release. He goes over the significantly reworked TeamCity Kotlin DSL and shows how projects can be set up programmatically, from just one settings file. The High Availability TeamCity setup with a read-only node installation is also explained. Finally, the revamped Docker support with the updated Docker runner is demonstrated, as well as the bundled Amazon S3 artifacts storage.

Q&A from the session

Kotlin DSL

Q: Where can I learn more about the language used for DSL?
A: The language is Kotlin:

Q: Is there a way to define meta-runners using Kotlin DSL instead of XML?
A: Not at the moment. They are present in repository as XML files. But the point of meta-runners is to provide the ability to reuse steps. In Kotlin you can write a function which defines the steps, so probably you don’t need meta runners there at all.

Q: Do existing settings and builds defined in the Kotlin language in TeamCity 2017.2 get automatically updated to the new version or is 2018.1 backward compatible with existing declared Kotlin build pipelines and settings?
A: They will continue working as before. Since this is code, manual changes should be done to migrate DSL to the new version. First of all, the package should be changed to v2018_1, then compilation errors should be fixed. The version in settings.kts should be changed too. Here is documentation on how to perform the migration:

Q: What would the TeamCity behavior be if we have a project configured in Kotlin with active branches and the snapshot dependencies are changed in settings.kts for a branch which is not the default branch (for example a feature branch which adds a new build configuration to the build chain, but isn’t merged to master yet)?
A: Before triggering a build chain in a branch, TeamCity already needs to know how this chain is configured. So it can take these settings only from the current project settings. It can’t load them from the branch. So snapshot dependencies are always taken from the current project settings (basically, loaded from the default branch of the settings VCS root).

Q: Is there support for subprojects in Kotlin DSL?
A: Yes, there is.

Q: Can we specify the checkout rules for VCS builds?
A: Yes, you can specify all the same setting that you have in the TeamCity web interface.

Q: Can I use this settings.kts file and execute the steps locally on dev environment to mimic TeamCity?
A: Unfortunately, not. The DSL generates configuration, it does not execute anything. It generates new config files, which are applied to the project and then you can run builds with new settings.

Q: How the plugin details /settings are configured in settings.kts file?
A: All the settings can be configured by supplying a set of text properties: everything which can be configured in the TeamCity settings XML can be done via the DSL. Plugins can also provide typed API to DSL to get DSL completion for their settings configuration.

Q: Do we have a stages-like model similar to Jenkins?
A: The pipeline in TeamCity is declarative, not imperative. You define a set of configurations combined by dependencies. The server decides how to execute this pipeline, in which order, etc. Depending on the settings, requirements, available agents.

Q: Can we define different snapshot and artifact dependencies in different branches?
A: You can store different settings.kts files in different branches and create different projects from them. But in a single project, you can’t have a different set of configurations or different dependencies.

Q: Can the build configuration differ per branch or is it always loaded from the default branch? For example, can pull requests also build with a new configuration?
A: By default, server loads settings from the branch specified in the VCS root. It is possible to configure the server to load settings from the branch where the build is executed, but there are limitations. You can’t for instance, have a different set of projects or build configurations, as well as different snapshot dependencies.

Read-only node

Q: Data directory can contain certificates/ssh keys – is that not a risk of adding in NAS?
A: Data directory contains all the settings necessary to access the repositories, the data should be protected with due permissions.

Q: Is there a license cost for a read-only TeamCity server?
A: No, you can run the read-only node without any extra licenses.

Anton ArhipovAnton Arhipov is a Developer Advocate for TeamCity at JetBrains. His professional interests include everything Java, but also other programming languages, middleware, and developer tooling. Java Champion since 2014. Anton is also a co-organizer of, a local developers community in Tallinn.
Posted in Features, Webinar | Tagged | 6 Comments

What’s New in TeamCity 2018.1, July 10th Webinar

Join us Tuesday, July 10th, 5:00 PM – 6:00 PM CEST (11:00 AM – 12:00 PM EDT) for our free live webinar, What’s new in TeamCity 2018.1 with Anton Arhipov.


In this webinar, Anton Arhipov will showcase all the major features of the latest TeamCity 2018.1. We will go over the significantly reworked TeamCity Kotlin DSL and show how projects can be set up programmatically, from just one settings file. The High Availability TeamCity setup will be demonstrated using a read-only node installation. Finally, we will look into the revamped Docker support with the updated Docker runner, as well as the bundled Amazon S3 artifacts storage.

Space is limited, please register now. There will be an opportunity to ask questions during the webinar.

Register for the webinar

Anton ArhipovAnton Arhipov is a Developer Advocate for TeamCity at JetBrains. His professional interests include everything Java, but also other programming languages, middleware, and developer tooling. Java Champion since 2014. Anton is also a co-organizer of, a local developers community in Tallinn.
Posted in Features, Webinar | Tagged | Comments Off on What’s New in TeamCity 2018.1, July 10th Webinar