Documents to help you prepare to migrate your Atlassian Server products.
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.
Documents that walk you through using the Confluence Cloud Migration Assistant to migrate to Cloud.
Documents that walk you through using the Bitbucket Cloud Migration Assistant to migrate to Cloud.
Documents to help you use Jira Site Import to migrate to 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.
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.
How to begin
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.
1. Identify all your current apps
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
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.
2. Identify apps you use
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.
3. Determine apps you need in Cloud
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.
4. Compare your Cloud and Server apps
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.
Frequently asked questions
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 do I do 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 do I assess the security considerations for using apps in Cloud?
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 understand if their Cloud app meets your security, legal and compliance standards.
Atlassian has implemented strict requirements for every app listed in the Atlassian Marketplace. Further, 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.
Apps with the ‘Cloud Security Participant’ badge in the Atlassian Marketplace listing have chosen to participate in Atlassian’s public bug bounty program where apps are tested by security researchers.
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)
5. Decide which apps to migrate
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.
What happens after auditing apps
Below are the two processes we recommend after auditing your apps.
Decide on your app migration strategy
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.
Clean slate migration
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.
Develop your app migration plan
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.
We have a number of channels available to help you with your migration:
Was this helpful?