Installation and upgrade

Owned by Rosen Marinkov
Last updated: May 22, 2024 by Julver Petrova (Deactivated)
4 min read

On this page:

Аpps you must install for migrations from Jira Server/Data Center to Jira Cloud

The Cloud Migration Tool (free) app supports migrating projects and issues from Jira Server/Data Center to Jira Cloud. To accomplish this scenario, you need to pair the Cloud Migration Tool app with our Configuration Manager for Jira Cloud (licensed) app.

First, you need to install Cloud Migration Tool on your Jira Server/Data Center instance and Configuration Manager for Jira Cloud on your Jira Cloud site.

Then, you can create a connection between them and start a migration process in the Cloud Migration Tool’s UI, as described in our articles. For more information, check out the use case documentation.

Supported Jira Cloud plans

You must have either the Standard, Enterprise, or Premium cloud plan. Trial or paid licenses of these three types are supported. Migrations to Jira Cloud on the Free plan are not supported. Learn more about the Jira Cloud plans.

Install Cloud Migration Tool on Jira Server

As of February 15, 2023, Atlassian ends the new server app sales.
What does this mean for Cloud Migration Tool?

You won’t be able to install the app from the Cloud Migration Tool listings in the Atlassian Marketplace and in Jira Server’s ‘Manage Apps' pages. You’ll need to manually download the app from its Marketplace page and upload it to your Jira Server instance.

For more information, you can read Atlassian’s full statement and End of sale and support for server apps article on this issue.

Follow the steps below to install the Cloud Migration Tool on Jira Server instances:

  1. Visit Cloud Migration Tool’s Atlassian Marketplace listing and set the hosting type to Server or Data Center from the Hosting options dropdown.

  2. Then, navigate to the Resources section at the bottom of the page and click the Download link.

  3. After Cloud Migration’s installation file is downloaded, log into your Jira Server instance as an administrator with the Jira System Administrators permissions.

  4. From the top navigation bar in your Jira Server, choose Add-ons or Manage apps.

  5. Click Manage apps from the left-hand side menu of the page.

  6. Click the Upload app link and provide the installation file downloaded in step 2.

  7. Follow the prompts to Install. The app is free, and you don’t need a license for it.

  8. You're all set! Click Close in the Installed and ready to go dialog.

Install Cloud Migration Tool on Jira Data Center

Install the Configuration Manager Cloud Migration Tool app on Jira Data Center instances.

  1. Log into your Jira Data Center instance as an administrator with the Jira System Administrators permissions.

  2. From the top navigation bar in your Jira DC instance, choose Add-ons or Manage apps.

  3. Click Find new apps or Find new add-ons from the left-hand side of the page.

  4. Locate Configuration Manager Cloud Migration Tool via search.

  5. Follow the prompts to Install. The app is free, and you don’t need a license for it.

  6. You're all set! Click Close in the Installed and ready to go dialog.

Install Configuration Manager for Jira (CMJ) Cloud

Install the Configuration Manager for the Jira Cloud app on your Jira Cloud site. Learn more about the Configuration Manager for Jira Cloud.

  1. Log into your Jira Cloud site as an administrator with the Jira System Administrators and Site аdmin or Organization admin permissions. You can learn more about the different admin roles in Atlassian’s documentation.

  2. From the top navigation bar in your Jira Cloud, choose Settings.

  3. Select Apps and then Find new apps.

  4. Search for Configuration Manager for Jira Cloud. 

  5. Follow the prompts to Get app, or get a Free trial.

  6. Be aware that you need a license for Configuration Manager for Jira Cloud. You might choose an evaluation license for the first 30 days.

Upgrade Cloud Migration Tool on Jira Data Center

  1. Log in to Jira as a user with the Jira System Administrators global permission.

  2. Click the cog icon on the top bar and select Manage apps. The Universal Plugin Manager (UPM) page will be displayed.

  3. On the Manage Apps page, look in the Apps Requiring Action section and locate Configuration Manager Cloud Migration Tool.

  4. Click the Update button.

To upgrade the Cloud Migration Tool manually (e.g. if your system does not have internet access), please download the app and then follow Atlassian's install from a file instructions.

Uninstall Cloud Migration Tool

To uninstall the Configuration Manager Cloud Migration Tool app, follow these steps:

  1. Log in as a user with the Jira System Administrator global permission.

  2. Click the cog icon on the top bar and select Manage apps.

  3. On the Manage Apps page, locate Cloud Migration Tool in User-installed apps. Click on it to display its details.

  4. Click the Uninstall button.