Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

How to register multiple remote agents for sequential use

UserName GoesHere March 9, 2018

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

0 votes
schow-lmi3d February 13, 2019

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
Atlassian Team members are employees working across the company in a wide variety of roles.
March 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.

UserName GoesHere March 16, 2018

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.

Jeyanthan I
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
March 20, 2018

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
AUG Leaders

Atlassian Community Events