Managing TeamCity build agents in your JetBrains Account

These instructions are intended for organization administrators. If you purchased your TeamCity server license as an individual using your personal account, you don’t need to assign your agent licenses manually. Any agents you purchase in the same account will be assigned to your server automatically.

Starting from version 2024.7, TeamCity supports online activation through the JetBrains Account portal. You no longer need to download offline license keys and manually enter them on your TeamCity server. Now, to activate your license, just click the Get license key button on your server and log in with your JetBrains Account. Refer to the TeamCity documentation for step-by-step activation instructions.

You only need to do this once. As long as your TeamCity server has an active internet connection, any changes to your license, including additional build agents, will be delivered to your TeamCity instance automatically.

However, for the process to go smoothly, you need to make sure that your build agent licenses are correctly assigned to your TeamCity server in your company’s JetBrains Account.

Using teams to manage your licenses

You can manage your TeamCity server and build agent licenses using JetBrains Account teams. A team is a subdivision within your company’s account that lets you independently manage subsets of your company’s licenses. If you haven’t used JetBrains Account teams before, check out this article to learn more about them.

To assign a build agent to your TeamCity server, you need to put the agent license into the same team that contains the server license. You can do so during the purchase or at any time after the purchase.

Assign new agents to a server during the purchase process

If you typically purchase licenses for your company, you can assign your build agents to a server during the purchase process by selecting the correct team on the checkout page. To do so:

1. Add the required number of build agents to your cart and proceed to checkout. 
2. At the top of the checkout page, open the Team dropdown list and select the team containing your server license. The team is indicated in the list by a TeamCity with X agents appendix after its name.
   
   If you have several TeamCity server licenses in separate teams and are not sure which team to select, follow the instructions at the bottom of this page to identify the correct team.
3. Complete the purchase.

That’s it! Your new agents are now assigned to your server. If your server license is already activated and your TeamCity server has an internet connection, the agent licenses will be delivered automatically. If not, you’ll need to follow the activation procedure to start using your agents. 

You can always reassign your agents after purchase by using the instructions below. 

Assign existing agents to a server

You must have organization administrator permissions to complete these steps. If you need help getting administrator permissions for your company's profile, please contact our Sales team.

To assign your existing agents to a server, you’ll need to transfer your agent licenses to the corresponding team. Here’s how you can do this:

1. Log in to your JetBrains Account.
2. Make a note of the name of the team to which your server license belongs.
   If you’re not sure which team that is, follow the instructions at the bottom of this page to find it. 
3. Follow these instructions to transfer your agent licenses to the team that contains your server.

That’s it! Your new agents are now assigned to your server. If your server license is already activated and your TeamCity server has an internet connection, the agent licenses will be delivered automatically. If not, you’ll need to follow the activation procedure to start using your agents.

Finding the team that contains a specific license

1. Log in to your JetBrains Account with organization administrator permissions.
2. In the menu on the left, click on your company's name.
   
3. At the top of the page, click View licenses.
   
4. Find your license on the license view page. You can search for it by license ID or use the filters at the top of the page.
   
5. Once you locate the license in the license table, find the team’s name in the Team column of the license table.
   

That’s the team that contains your license. To give someone else access to this license, invite them to this team as an administrator.