How to speed up home folder migration during upgrade to Bamboo 8.0 or higher

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.


During the upgrade of Bamboo to version 8.0 or higher the home directory gets restructured as indicated in This operation my take a long time to finish depending on your configuration and amount of files inside the <bamboo-home>/artifacts folder.

If your entire home folder is on the same disk and you're not using a custom location for the shared folder, the shared folder will be created inside your current <bamboo-home> folder. Your artifacts and other files will be moved there. This operation is quite quick and the additional steps in this KB are not required.

If you have a large artifacts folder that's mounted on a different storage other than the <bamboo-home>/artifact folder, moving artifacts to the new shared folder that gets created during the upgrade can be a time consuming task. The move command (Linux mv) used by Bamboo to move the files is quick when both origin and destination locations are on the same disk. However, if that is not the case the time will depend on the number and size of the files. 


  • Upgrade of Bamboo to version 8.0 or higher.
  • Artifact folder mounted on a shared storage or different disk than the <bamboo-home> folder.


The steps below need to be integrated to your upgrade run book.

You can skip the migration of the artifact folder using the following steps:

  1. Shutdown Bamboo.
  2. Take a backup of the <bamboo-home> folder and database.
  3. Create folder named shared inside your <bamboo-home> folder:

    cd $BambooHomeDir 
    mkdir shared
  4. Reconfigure the mount of the artifact directory from <bamboo-home>/artifacts to <bamboo-home>/shared/artifacts (this will depend on how you configured the mount on your Linux environment).
  5. Update the <bamboo-home>/bamboo.cfg.xml file with this exact configuration: 

    <property name=“”>${bambooSharedHome}/artifacts</property>

    It is NOT necessary to replace ${bambooSharedHome} with the complete path to your <bamboo-home> folder.

  6. Start Bamboo 8.0 or higher to start the upgrade (during the upgrade task only the artifacts folder copy will be skipped).

During the upgrade, it's expected to see messages like:

2021-11-10 19:47:36,024 INFO [localhost-startStop-1] [UpgradeTask70302ReorganiseHomeDirectory] Moving /home/charlie/bamboo-home-folder/artifacts to /home/charlie/bamboo-home-folder/shared/artifacts... 
2021-11-10 19:47:36,024 WARN [localhost-startStop-1] [UpgradeTask70302ReorganiseHomeDirectory] Did not found the path /home/charlie/bamboo-home-folder/artifacts. You might need to migrate it manually. 
2021-11-10 19:47:36,024 INFO [localhost-startStop-1] [UpgradeTask70302ReorganiseHomeDirectory] Property [] is set to [/home/charlie/bamboo-home-folder/shared/artifacts]. Not changing it. 

Last modified on Jun 20, 2022

Was this helpful?

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