How to change the build working directory location on a remote agent

Still need help?

The Atlassian Community is here for you.

Ask the community


Change the build working directory location on a remote agent.

This can be useful when we have a different partition or disk drive to store your data.

It is also an option to reduce the path used for your builds (to deal with Windows 260 character limits).


  1. Stop your agent
  2. Edit the <Agent_Home>/bamboo-agent.cfg.xml file changing the value set for the property buildWorkingDirectory to the new location
  3. Remove the content from your old build-dir location (do not move it, we want the agent to recreate the build data).
    In case you have the repository cache configured to be saved on the agent side this renewal will cause the first build of your plans to be slow until the new cache is built.
  4. Start your agent

Last modified on Aug 31, 2017

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.