In case you need to clone your production instance to a test/staging instance in order to prepare migrating to another database or upgrading Bamboo.
For example, you may want to transfer your current production snapshot to a test server as permitted in the license agreement.
![]() |
|
License
Development licenses are available for any Commercial or Academic license. Create one or contact us for help.
Clone production instance - standard
This is the simple and straight forward way to clone your instance
- Export/Backup your current instance.
- Copy zip across to new server.
- Install the same version of Bamboo on new server.
- Point Bamboo.home in <bamboo-install>/webapp/WEB-INF/classes/bamboo-init.properties to your new Bamboo home directory.
- Start the new instance.
- Complete the setup wizard, choose 'import existing data'.
Clone production instance - alternative
If your current instance has grown too large and export/import does not work you can still clone your instance using an alternative backup and restore strategy.
The purpose is to clone <bamboo-home> and make it available to the new test/clone instance.
- Shutdown production Bamboo at a convenient time.
Create a backup:
embedded DB
external DB
(Optional) Reduce the size of this zip by deleting the xml-data/build-dir – this directory only contains working copies of checked out sources.
Zip <bamboo-production-home> directory; the embedded database will be part of this zip.(Optional) Reduce the size of this zip by deleting the xml-data/build-dir - this directory only contains working copies of checked out sources.
Zip <bamboo-production-home> directory.
Create a backup with the native tools provided by your DB.- Restart production Bamboo.
- Transfer the home.zip to your cloned instance and unzip into <bamboo-clone-home>.
- (External DB only) Create a new database for the cloned instance and import the db dump.
- Edit <bamboo-clone-home>/bamboo.cfg.xml and <bamboo-clone-home>/xml-data/configuration/administration.xml and change the server names/ip addresses according to the new location.
- (External DB only) Edit <bamboo-clone-home>/bamboo.cfg.xml and enter the new database connection details and credentials.
- Point bamboo.home of your cloned instance to the unzipped <bamboo-clone-home> directory.
- Start the Bamboo clone.
This should give you a perfectly cloned instance.
Your next steps
- If the new server has different locations for
- JDKs
- Ant
- Maven
- Perforce
- Msbuild tools
adjust the settings in the server capabilites settings to match the locations on the new machine.
- From here you can upgrade if desired.
- After the upgrade you should be able to export your instance without problems and then migrate to another database for instance.