Skip to main content
Skip table of contents

Migrate a Jira server with a running Backbone sync

You can migrate a Jira instance with a running Backbone synchronization to another server.

Avoid running Backbone synchronizations in both Jiras at the same time

Please avoid that Backbone synchronizations are running in both Jiras at the same time. If this happens, you will probably end up with many duplicate issues - and it requires significant effort to clean them up afterwards. If you follow the steps described below, you don’t need to worry.

  1. Stop all your Backbone synchronizations. This step is important to avoid that Backbone synchronizations are automatically started again as soon as you start your Jira server.

  2. Perform a 'standard' Jira migration. Backbone stores its data in the Jira database and on the file system of your Jira instance. You can find the data under the path Jira-Home/data/backbone-issue-sync. Please copy all folders and files from Backbone's folder to the new Jira home location of your Jira instance.

  3. After migration, start Jira and go to the global list of Backbone synchronizations under Administration > Manage add-ons/apps > Synchronizations. Then update the URLs of all Backbone synchronizations.

  4. Start the synchronizations again.

Good to know

If you perform migrations automatically or copy/clone your Jira instances on a regular basis, you can also use a system property to avoid that Backbone automatically starts all synchronizations after restarting Jira.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.