Specifying Bamboo's working directory

The working directory is where Bamboo temporarily places the checked-out files it's building. The location of this directory is first specified in the Setup Wizard. You can check its location as described in Bamboo's system information and change it by following the instructions on this page.

Once you change the working directory, Bamboo will perform a fresh checkout and clean build of all your plans.

By default, this directory is located at <bamboo-home-dir>/local-working-dir, where <bamboo-home-dir> is the Bamboo home directory.

The checked-out files for each job are stored in a sub-directory relative to the configured working directory:


If concurrent builds are enabled, the path to local agent build files will use the following format:


To change the location of Bamboo's working directory:

  1. Shut down Bamboo.
  2. Open the <bamboo-install-dir>/bamboo.cfg.xml file in a text editor.

  3. Set the path to the new working directory on the following line:

    <property name="buildWorkingDir">${bambooHome}/local-working-dir</property>
  4. Save the changes and restart Bamboo.
Last modified on Feb 20, 2024

Was this helpful?

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