Plan your Cloud migration
Documents to help you prepare to migrate your Atlassian Server products.
Plan your Cloud migration
Documents to help you prepare to migrate your Atlassian Server products.
User management and migration
App assessment and migration
A collection of topics that help prepare you to migrate your apps to the Cloud.
Ensure you’re ready to migrate with these pre-migration checklists for Jira, Confluence, and Bitbucket Server or Data Center.
Jira Cloud Migration Assistant
Migrate your Jira data with the Jira Cloud Migration Assistant. This is the recommended way to migrate.
Confluence Cloud Migration Assistant
Migrate your Confluence data with the Confluence Cloud Migration Assistant. This is the recommended way to migrate.
Bitbucket Cloud Migration Assistant
Documents that walk you through using the Bitbucket Cloud Migration Assistant to migrate to Cloud.
Jira Site Import
Documents to help you use Jira Site Import to migrate to Cloud.
Get up and running in Cloud
Resources to help get started and testing after you migrate.
Everything you need to know about moving your data from one cloud site to another.
Copy Confluence data
Everything you need to know about copying your Confluence data within or across organizations
Migration best practices
A set of optional best practices that you can apply to your migration.
It's important to understand the apps you currently use before developing your app migration plan. Auditing your apps is a good approach to help you do this and determine what course of action to take for your migration.
This page explains strategies and tools that you can use to practice, research, and improve your app audit and develop your migration strategy. At the end of this page, you’ll also find more information about Atlassian's guides to migrating to Cloud, and using the Cloud Migration Assistants.
Your migration will be more successful if you take time to research what apps you currently use, evaluate which apps are critical and decide which apps you may or may not need in Cloud.
You’ll first need to find out:
which apps you have currently installed in Server
the cost of each app
You can do this by:
using the Cloud Migration Assistant (if installed), or
manually identify apps through your admin settings.
The table below explains these options.
Cloud Migration Assistant
In the Confluence Cloud Migration Assistant or Jira Cloud Migration Assistant home screen, navigate to Assess your apps. This feature will:
You can see a list of your apps by:
If you can't assess your apps using the Cloud Migration Assistant, we've created an app audit template you can use to manually track your apps. The template helps you record things like product, app name, what you're currently paying, and whether or not the app offers critical functionality. Learn more about the app audit template
To use the template, copy it and then customize it to suit your needs.
Next, you'll want to find out which apps are actually used, and which aren't. Below are some common strategies to identify if and how your apps are used.
Once you have a list of your current apps and an understanding of how they're being used, it's time to decide the apps you need, and those that aren’t needed. It's common to find that not all of your apps are being used, or that even those being used are not mission-critical.
Even when apps are being used heavily, many customers choose to use a migration as a chance to clean up. For example, you may want to simplify things like overly complicated workflows in Jira. App audits provide Server admins a great opportunity to make people aware of the problem, ask questions, and give them the opportunity to decide if they want to keep everything or consider alternatives.
In some cases, the features offered by Server apps are either not needed in Cloud or are already available as features in our Cloud products.
Starting with your essential apps, determine if each offers a cloud equivalent, and assess feature parity. Below are some common questions you may have as you complete your comparison.
Marketplace Partners (app vendors) are accountable for app data security in Cloud. For this reason, it is important that you contact your individual Marketplace Partners while auditing and assessing your apps, to determine if their Cloud app meets your security, privacy, reliability, legal and compliance standards.
To begin assisting you with this assessment:
Atlassian’s Marketplace trust programs provide signals to identify the trust postures of apps in Cloud.
Atlassian has also implemented strict requirements for every app listed in the Atlassian Marketplace. Third-party apps are expected to comply with industry aligned security self-assessment, and GDPR and European regulations on data and privacy.
The Cloud Fortified Apps program can help you find Atlassian Marketplace Cloud apps with advanced security, reliability and support.
Atlassian provides a ‘Cloud Security Participant’ badge in the Atlassian Marketplace listing for apps that have chosen to participate in Atlassian’s public bug bounty program, and are tested by security researchers.
Learn more about app security in the Cloud migration guide
How can I tell if Server and Cloud apps offer the same features?
The best place to start is by looking at your Server apps to see if they have a comparable version for Cloud. Keep in mind that like Atlassian's products, Cloud apps can differ in features and functionality from the Server version, so you'll want to check that the Cloud version has the primary features you need.
You can do all of this using the app assessment feature in the Cloud Migration Assistants if you have them installed on your Server.
We also recommend carefully reviewing the Marketplace listing for each app, and contacting the Marketplace Partner with any questions.
What if an app isn't available in Cloud?
There are a few things you can do if the app you need isn't available in Cloud. You can:
Contact the Marketplace Partner (vendor): Reach out to the Marketplace Partner to see if they're currently working on a Cloud version. It may be possible that they're planning to release one soon, in which case you'll want to find out what functionality it will offer and what their timelines are.
Check the list of alternative apps you could switch to. Learn more about Cloud alternatives to Server and Data Center apps
See if there are similar apps available in Marketplace.
Look up alternatives in the CMA: If you are using the Cloud Migration Assistant, apps that you select Use alternative for will automatically show you Marketplace alternatives in the next screen. It's important to understand that these are not recommended by Atlassian, and are selected based on similarity in functionality.
Decide not to migrate the app: If the app isn't essential or isn’t being used, you may choose not to migrate the app.
How can I compare pricing between Server and Cloud?
For each app, check the pricing tab on the Marketplace listing to see if there's a Cloud equivalent and calculate Cloud costs.
If your app doesn't have a Cloud version, review alternative apps and pricing information. Keep in mind there may be multiple alternatives to consider.
Record costs for Server and Cloud in our app audit template to compare pricing. Learn more about the app audit template
How can I test apps in Cloud to see if they have what we need?
You can test the apps you need in Cloud by starting a free app trial on your test Cloud instance. Your testing options include any of the following:
a free migration trial
a Standard 7 day trial (this will revert to a Free plan after the trial)
a Free plan, with a maximum of 10 users (recommended for small teams)
Learn more about testing your Server to Cloud migration
After completing your audit, you should have a good understanding of your current app landscape and what your options are for moving them to Cloud. Now it's time to review your audit with stakeholders and decide what to do going forward. Again, we recommend starting by determining what's essential, what isn't, and prioritising from there.
Help your team understand the following:
Which apps and functionality will be available in Cloud after you migrate, and what does this mean for the day-to-day work of the team?
How does your app migration timeline fir into Atlassian discontinuing selling server licenses? Learn more about server licenses
Keep in mind as you evaluate that you may also have custom apps or integrations to consider. In most cases, the same guidance will apply.
Below are the two processes we recommend after auditing your apps.
The two most common app migration strategies are selective migration and clean slate migration.
Migrating to Cloud gives you the chance to simplify and remove apps from Server instances that have grown organically, were acquired by acquisition, or that lacked strong app governance. This approach involves using the audit process outlined in this guide to:
work out which Server apps are needed in Cloud
determine the migration paths available
migrate app data to the Cloud app, leaving anything you don't need
This method is best supported using the Jira and Confluence Cloud Migration Assistants, which currently automate the app assessment process.
Learn more about assessing and migrating apps with the Cloud Migration Assistant
Instead of first auditing your apps, you may choose to remove all of your apps when migrating to Cloud, and then adding apps you need in Cloud after you migrate. You might consider this if:
you have a Server instance that you'd like to simplify in Cloud, or
if you only have a few non-critical apps.
Once you've determined which apps and functionality to migrate, you'll need to develop your app migration plan. Keep the following in mind:
The migration of app data is highly dependent on the Marketplace Partner (vendors/app developers) of each app, as they will need to provide a migration path to move app data to cloud. We recommend you work with Marketplace Partners of the apps you intend to migrate to review their documentation and determine the best way to migrate each app.
Apps do not need to be disabled or uninstalled from Server before migrating. If your apps are still active when the migration occurs, the migration will still be successful.
Learn more in the Cloud migration guide
We have a number of channels available to help you with your migration:
for migration planning information, visit the Atlassian Migration Program website
for technical issues or support with strategy and best practices, get in touch with our support team
for peer advice, ask the Atlassian Community
for expert guidance, work with an Atlassian Partner
Was this helpful?