Bamboo home migration

Still need help?

The Atlassian Community is here for you.

Ask the community

As part of the warm standby capabilities of Bamboo Data Center, major changes were made to the home folder. The new organization is a requirement for using multiple nodes with Bamboo Data Center, but this upgrade will affect every type of Bamboo installation, including Server and single-node Data Center setups.

This upgrade splits the home folder into two parts: one containing data that will be exclusive for each instance, and another folder that contains the files that will be shared among every node. We will refer to these folders as local home and shared home respectively.

Who does it affect?

This upgrade task is applied to every instance of Bamboo migrated to a clustered Bamboo Data Center setup and doesn’t contain custom paths for folders that are by default placed inside Bamboo’s home folder or if you execute the migration manually, before upgrading your instance.

Bamboo will not move your data if your instance is configured with custom paths. Keep in mind that multiple nodes will require access to these folders when using warm standby.

Do I use custom paths?

To find this information:

  1. In the upper-right corner of the screen, select
    Administration bamboo administration icon
    > Overview.
  2. From the sidebar, under System, select System information.
  3. On the System information page, scroll down to Bamboo paths.

    The listed directories must all be located in the Bamboo home folder.

What will be changed?

Certain folders and their data will be moved to the /shared folder, inside Bamboo home.

If you are upgrading to a Data Center license and plan to use the warm standby setup, you need to make sure the shared folder will be available over the network for every node. Keeping a network-shared folder inside the Bamboo home might be sub-optimal and you might want to place it somewhere outside. You can do that by configuring a different shared home location. See Configuring shared home location.

We also took the opportunity to make minor adjustments to simplify the names of folders.

Lucene indexes were moved to the shared home folder and that impacts the velocity of reindexing in Bamboo. We deprecated Lucene in Bamboo 8.0.

Follow the list of folders and files that are being migrated. Keep in mind that the default location for <bamboo-shared-home> is inside the local home <bamboo-home>/shared.


Path before the migration

Path after the migration



















JMS store






Server state






Repositories cache



Build results






Cluster info



How do I know if the migration is completed?

Once the migration is completed, you will see the following message in the application logs:

2021-01-01 00:00:00 INFO [Thread] The migration of folders to the shared home has been completed.

If there is an error during the execution of this upgrade task, please follow the instructions provided or if you need help, contact Atlassian support.

Last modified on Jan 23, 2024

Was this helpful?

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