Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

How to register multiple remote agents for sequential use

We have Bamboo Server 6.2.3 installed in a local network. 

We have a license for one remote agent in an installation in which Bamboo does deployments to small numbers of servers.  We expect the deployments to run SEQUENTIALLY on the remote agents because we only have a license for one remote agent.  We do NOT expect the deployments to run in PARALLEL on multiple remote agents because we did not purchase multiple remote agent licenses. 

We have remote agents installed on 2 servers, with each of the remote agents dedicated to its own specific Deployment Plan. This is as expected because our single remote agent license only allows one remote agent to run at a time. 

But when we try to register a third remote agent by running the following command on a new server: 

    sudo java -jar /opt/atlassian/bamboo-agent/atlassian-bamboo-agent-installer-6.2.3.jar

We get the following error: 

Mar 9, 2018 2:47:52 PM A remote agent is loading on localhost (

Mar 9, 2018 2:47:58 PM Registration attempt rejected with a message: Cannot register additional remote agent. You have reached the limit for the number of remote agents you can have. Please upgrade your license.


**What do we need to do in order to be able to register the third remote agent with Bamboo, so that it can be used separately, one agent at a time in linear sequence, the way our other remote agents seem to work?**

2 answers

I am also having the same problem.

I was told by atlassian support I could have an infinite amount of remote agents but only N amount of remote agents will handle a job depending on how many N licenses are purchased.

Why can't I have 15 remote agents when I have a 10 license for example?

0 votes
Robert W Atlassian Team Mar 16, 2018




With a single remote agent license, you are restricted to only having a single remote agent online at a time.


In order to add a new remote agent, you'll need to take the other agents offline first.  Likewise in order to deploy across the multiple agents you'll need to take each agent offline after it's processed its deployment, and then bring the next online.

We only want to use one remote agent at a time.  But we need for the agents to be able to be called programmatically. 


Note that there are already two remote agents that can be seen and used from within the Bamboo installation.  Therefore, Bamboo seems to be able to handle multiple remote agents being available in our current license level.  So I repeat, what can we do in order for additional remote agents to be able to be registered and available for the same treatment that the existing TWO agents are receiving? 


We do not want parallel processing.  We only want Bamboo to be able to activate and de-activate the agents programmatically.

Hi UserName,

Could it be that one of the remote agents is still running and not stopped properly? You may have to force kill the running one and retry in that case.

Suggest an answer

Log in or Sign up to answer

Atlassian Community Events