How to configure the temporary directory for a Bamboo remote agent

Still need help?

The Atlassian Community is here for you.

Ask the community

Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.

Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

The information in this page relates to customizations in Bamboo. Consequently, Atlassian Support cannot guarantee to provide any support for the steps described on this page as customizations are not covered under Atlassian Support Offerings. Please be aware that this material is provided for your information only and that you use it at your own risk.

Also, please be aware that customizations done by directly modifying files are not included in the upgrade process. These modifications will need to be reapplied manually on the upgraded instance.


For some scenarios, it might be required to change or configure the temporary directory (Java temporary folder) for remote agents. For example, when two remote agents are installed on the same machine, as two agents sharing the same temporary directory can cause issues during build execution.


Applicable to remote agents on all supported versions of Bamboo.


Please follow the instructions below to change the temporary directory for a Bamboo remote agent:

  1. Stop the remote agent.
  2. From <remote-agent-install>/conf, open wrapper.conf.
  3. Find the section # The Bamboo Agent home configuration file, and add a line that must contain the following information:

    Change the X to the next number following the sequence.

  4. Change /path/to/directory to the desired directory and save the changes.
  5. Start the remote agent.

These steps are meant for remote agents only. In order to change the temporary directory path for Bamboo server itself, please see How to configure temporary directory in Bamboo server.

Last modified on Oct 30, 2023

Was this helpful?

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