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

Earn badges and make progress

You're on your way to the next level! Join the Kudos program to earn points and save your progress.

Deleted user Avatar
Deleted user

Level 1: Seed

25 / 150 points

Next: Root


1 badge earned


Participate in fun challenges

Challenges come and go, but your rewards stay with you. Do more to earn more!


Gift kudos to your peers

What goes around comes around! Share the love by gifting kudos to your peers.


Rise up in the ranks

Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!


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

Bamboo Agent Name keeps defaulting to on Mac OSX

I have been trying to automate Bamboo agent configuration as part of my automation setup. However, although I have changed the hostname to something, e.g. mactest-xxxx, the agent name is defaulted to "" on Bamboo server dashboard. I have been looking around places where might have been cached, including /etc/hosts, but so far no luck. I have even pre-filled bamboo-agent.cfg.xml with the intended name ("mactest-xxxx"), and the agent does not even show up on the Online agent list in dashboard.

Where does Bamboo agent gets its name from on Mac OSX?

1 answer

Hello @Reynaldo Adji,

The agent will use this to get the name and send it over to Bamboo. If it can resolve it, it will use the name. If it can't, it will then use the IP address. From there Bamboo has to ensure uniqueness of the name. It does this by adding a number suffix (if needed).

There is an improvement request filed ( requesting to address remote agent's name from <BAMBOO_AGENT_HOME>/bamboo-agent.cfg.xml. I would suggest you on voting, becoming a watcher and commenting on the link so it can increase its popularity.

If you need to rename the agent and ensure consistency you'll have to go through the following steps every time you need to do this:

  1. Open up the remote agent <BAMBOO_AGENT_HOME>/bamboo-agent.cfg.xml file and change the <name> tag to rename the remote agent.
  2. From the UI go to the Bamboo administration > Agents page.
    • Locate the remote agent from step 1 under the tabs "Online" or "Offline".
    • Click the agent name. You'll get redirected to the remote agent summary page.
    • Click Edit details.
    • Use the "Name" field to rename the remote agent.

Basically you'll have to rename the agent in two different places. You'll have to go through steps 1 & 2 to rename the remote agent and ensure that both the bamboo-agent.cfg.xml file and the database are in sync.

Kind regards,


Is there any other way to change the agent name without using the UI? Maybe rest API endpoint? I don't want to automate UI if I don't really have to. 

rsperafico Atlassian Team Apr 04, 2018

Hello @Reynaldo Adji,

There is no REST API endpoint available to update agent. Instead, what you could do is call the action from "Click Edit details." described previously:

# replace BAMBOO_ADMIN_USER with user with global administration privileges
# replace AGENT_ID with id from agent you want to perform an update
# replace AGENT_NAME with desired name, e.g My+Agent
# replace AGENT_DESCRIPTION with description, e.g My+Agent+Description
# replace http://localhost:8085 with Bamboo's Base URL

curl -k -u BAMBOO_ADMIN_USER \
     -H 'Content-Type: application/x-www-form-urlencoded' \
     -H 'X-Atlassian-Token: no-check' \
     -d 'agentId=AGENT_ID&agentName=AGENT_NAME&agentDescription=AGENT_DESCRIPTION' \
     -X POST 'http://localhost:8085/admin/agent/updateAgentDetails.action'

As mentioned previously, there is an improvement filed ( in which request a way to rename agent and performing this action will not update <BAMBOO_AGENT_HOME>/bamboo-agent.cfg.xml. Manual update is required.

Kind regards,


Suggest an answer

Log in or Sign up to answer

Atlassian Community Events