How to configure temporary directory on a FreeBSD OS 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 on 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.


This document covers how to change a temporary directory on remote agents running on the FreeBSD OS server. We have seen some scenarios where remote agents running on the FreeBSD OS server don't generate a <remote-agent-install>/conf/wrapper.conf file and will not be possible to change the temporary directory directly through the wrapper.conf file as explained in the document how-to-configure-temporary-directory-in-bamboo-remote-agent. If you are running remote agents on the FreeBSD OS server and you see a wrapper.conf file under <remote-agent-install>/conf directory, you can change the temporary directory by following the steps mentioned in the document how-to-configure-temporary-directory-in-bamboo-remote-agent. And in case there is no <remote-agent-install>/conf/wrapper.conf file created on your remote agent, you can follow the below steps mentioned in this document under the solution section.


Applicable to remote agents running on FreeBSD 11 OS server on all supported versions of Bamboo.


Please follow the below steps to change the temporary directory for a Bamboo remote agent running on the FreeBSD OS server:

  1. Stop the remote agent.
  2. Start the remote agent now with below command: 

    $Java_Home_Path -Dbamboo.home=<Bamboo-agent-home>"<Temp_directory_path>" -jar <Bamboo-agent-home>/lib/bamboo-agent-bootstrap.jar <Bamboo-Base_URL>/agentServer/

    (info) Replace <Temp_directory_path> with the temporary directory path you want set on remote agent

    (info) Replace <Bamboo-Base_URL> with your Bamboo base url

    (info) Replace $Java_home_path with Java home path which remote agent server is installed

    (info) Replace "X" value in the "" parameter with the next number following the sequence

    (info) Replace <Bamboo-agent-home> with the Bamboo agent home path 

    For example: 

    /usr/local/openjdk8/jre/bin/java -Dbamboo.home=/var/atlassian/application-data/bamboo-agent/"" -jar /var/atlassian/application-data/bamboo-agent1/lib/bamboo-agent-bootstrap.jar



Last modified on Jul 7, 2023

Was this helpful?

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