Installation and Upgrade
On this page:
Which apps do you need to install for a migration from Jira Server to Cloud?
The use case supported by our Cloud Migration Tool (free app) is migrating projects and issues from Jira Server/Data Center to Jira Cloud. To accomplish the scenario, you need to pair Cloud Migration Tool 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.
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:
Visit Cloud Migration Tool’s Atlassian Marketplace listing and set the hosting type to Server or Data Center from the Hosting options dropdown.
Then, navigate to the Resources section at the bottom of the page and click the Download link.
After Cloud Migration’s installation file is downloaded, log into your Jira Server instance as an administrator with the Jira System Administrators permissions.
From the top navigation bar in your Jira Server, choose Add-ons or Manage apps.
Click Manage apps from the left-hand side menu of the page.
Click the Upload app link and provide the installation file downloaded in step 2.
Follow the prompts to Install. The app is free, and you don’t need a license for it.
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.
Log into your Jira Data Center instance as an administrator with the Jira System Administrators permissions.
From the top navigation bar in your Jira DC instance, choose Add-ons or Manage apps.
Click Find new apps or Find new add-ons from the left-hand side of the page.
Locate Configuration Manager Cloud Migration Tool via search.
Follow the prompts to Install. The app is free, and you don’t need a license for it.
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.
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.
From the top navigation bar in your Jira Cloud, choose Settings.
Select Apps and then Find new apps.
Search for Configuration Manager for Jira Cloud.
Follow the prompts to Get app, or get a Free trial.
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
Log in to Jira as a user with the Jira System Administrators global permission.
Click the cog icon on the top bar and select Manage apps. The Universal Plugin Manager (UPM) page will be displayed.
On the Manage Apps page, look in the Apps Requiring Action section and locate Configuration Manager Cloud Migration Tool.
Click the Update button.
Uninstall Cloud Migration Tool
To uninstall the Configuration Manager Cloud Migration Tool app, follow these steps:
Log in as a user with the Jira System Administrator global permission.
Click the cog icon on the top bar and select Manage apps.
On the Manage Apps page, locate Cloud Migration Tool in User-installed apps. Click on it to display its details.
Click the Uninstall button.