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.
After you've successfully completed the migration, you'll need to go through a series of post-migration tasks to ensure that everything is functioning as smoothly and efficiently as possible.
Review your Cloud site
When your migration is complete, you will need to review the new Bitbucket Cloud site to ensure your data has migrated successfully. We recommend:
checking repositories for things like your commits and branches
allowing time for different teams and users to test different functionality
testing the operation and functionality of the application to identify any behavior gaps and, if needed, document them for your users
Review and assign user permissions
Once you have migrated to Bitbucket Cloud, you will need to create the necessary groups, assign members to these groups, and set the permissions for those groups to access any repositories. We are working on migrating user permissions to Bitbucket Cloud in a future release. For more information, see the Bitbucket Cloud migration roadmap. Learn how to query a list of all permissions and users in Bitbucket Server
Project settings and permissions
We are currently working on creating more parity between projects in our Server (and Data Center) products and Bitbucket Cloud. Check out the Bitbucket Cloud roadmap for more information on release dates and timing for project settings and permissions to be available in Bitbucket Cloud.
Add default reviewers
You will need to manually add your default reviewers from Server over to your new Cloud destination. For more information on when default reviewers will be migrated, see the Bitbucket Cloud roadmap.
Once you have migrated to the Cloud, you will need to set up your branch permissions to match what you had set up in Server. Learn about using branch permissions in Bitbucket Cloud
Webhooks will not be migrated to Bitbucket Cloud using the migration assistant, and this feature is not currently on the Bitbucket Cloud roadmap. Learn about managing webhooks in Bitbucket Cloud
You will need to suggest or enforce merge checks across your repositories in your new Cloud destination. For more understanding around merge checks in Bitbucket Cloud, see Suggest or require checks before a merge.
Connecting your Bitbucket Cloud workspace to Jira Software
Having your commits, branches, pull-requests, builds and deploys reported into Jira brings a massive amount of visibility into your development flow. As you have just migrated from Bitbucket Server, you should be familiar with this value and want to connect your Bitbucket Cloud workspace to your Jira instance.
If you’re on Jira Server, see Connect Bitbucket Cloud to Jira Software Server.
If you’re on Jira Cloud, see Connect Bitbucket Cloud to Jira Software Cloud.
If you've identified apps that should be installed, add them to your Bitbucket Cloud site.
Get acquainted with Cloud
To learn more about what's new in Bitbucket Cloud and how to get the most of it, check out the Bitbucket Cloud documentation. Consider sharing this resource with your users if this is their first introduction to Bitbucket Cloud. You may also find the Atlassian Cloud documentation a helpful resource as you get started as a Bitbucket Cloud admin.
Welcome your team
Now that the migration is complete, make sure your organization is ready. We recommend developing a comprehensive launch communication plan to share the new Bitbucket Cloud site information with the team. This can cover topics like:
actions needed post-migration, for example:
updating local remote URLs for migrated repositories
the URL they will use to access the new site
who they can contact with questions, for example, can you provide a chat room or an issue tracker where people can raise any issues or feedback
any notable changes they need to be aware of
links to any further reading or FAQs
Sit back and relax
Now that you're a Cloud admin, you'll have immediate access to our latest features and bug fixes. Installs, upgrades, and patches are managed seamlessly by Atlassian, so you can relax on your weekends.
To keep track of major changes that affect all users of the Bitbucket Cloud products, follow the Atlassian Cloud Documentation blog. This includes new features, bug fixes, and other changes across all Atlassian Cloud products. You can also take a look at our Bitbucket Cloud general enhancements roadmap to stay informed about the latest features coming to Bitbucket Cloud.
More information and support
We have a number of channels available to help you with your migration.
Our Bitbucket Cloud support team can help with technical questions or issues related to your migration.
For help with a large-scale migration, we also have a wide network of partners globally that are experienced in Atlassian migrations. Get in touch to find one who can help with your migration.
Looking for peer advice? Ask the Atlassian Community.
Want expert guidance? Work with an Atlassian Partner.
Support for Atlassian Server products ends in February, 2024. Learn more about the Server end of support timeline.
Was this helpful?