• Products
  • Documentation
  • Resources

Update or install the Jira Cloud Migration Assistant

Update Jira Cloud Migration Assistant to the latest version

We always recommend that you update to the latest version to get all improvements and fixes. In one of the recent releases, version 1.10.17, we significantly improved migration speed, so it’s important that you upgrade to this version or one of the later ones.

The Jira Cloud Migration Assistant is an app available for Jira Server and Data Center.

Supported versions

The assistant is pre-installed in these versions:

  • Jira 8.14 and later

  • Jira Service Management 4.14 and later

You can install it manually in these versions:

  • Jira Core Server 7.6, or later

  • Jira Software Server and Data Center 7.6, or later

  • Jira Service Management Server and Data Center 3.9, or later

If you're on an unsupported Server or Data Center version and don't have active maintenance on your server license (which is required to upgrade), you can use a free trial license to upgrade in preparation for your migration. Learn how to migrate to cloud with an expired Server license

Before you begin

Here’s some prerequisite information:

Allowlist Atlassian domains and IP addresses in your network

If your Jira Server or Data Center instance is behind a firewall, you need to allow access for domains and IP addresses needed by the assistant. Learn more about IP addresses and domains

No downtime or restart needed

The migration assistant is a Marketplace app. You can install it without restarting your Jira instance. It also doesn’t require downtime or Jira backups – if the installation fails, it won’t affect your Jira instance.

Limited recovery support (Data Center only)

The Jira Cloud Migration Assistant supports limited recovery in the case of a server failure during migration. To maximize recovery capabilities, we recommend only running one migration at a time per two Data Center nodes.

In the case of a server failure during migration, the assistant will:

  • if the server failure occurs during export, automatically recover the migration up to two times, as long as there are two Data Center nodes per migration and both don’t crash at the same time

  • if the server failure occurs during import, automatically recover the migration an unlimited number of times, as long as there are two Data Center nodes per migration and both don’t crash at the same time

In the event that all Data Center nodes crash, then recovery (as outlined above) isn’t guaranteed. However, recovery may still be possible if one node (per migration) is restarted within three minutes.

Install the Jira Cloud Migration Assistant

To install the assistant:

  1. In Jira Server or Data Center, go to Administration > Manage apps.

  2. Select Find new apps.

  3. Search for Jira Cloud Migration Assistant.

  4. Select Install.

Update the Jira Cloud Migration Assistant

To update the assistant:

  1. In Jira Server or Data Center, go to Administration > Manage apps.

  2. Select Manage apps.

  3. Search for Jira Cloud Migration Assistant.

  4. Select Update.

Open the Jira Cloud Migration Assistant

To open the assistant:

  1. In Jira Server or Data Center, go to Administration > System > Migrate to Cloud.

  2. You’ll see a home screen similar to this one:

Home screen of the Jira Cloud Migration Assistant.

To learn more about each card, see:


More information and support

We have a number of channels available to help you with your migration.

Support for Atlassian Server products ends in February, 2024. Learn more about the Server end of support timeline.

Still need help?

The Atlassian Community is here for you.