Cloud migration methods for Bitbucket

The Bitbucket Cloud Migration Assistant is the recommended method to migrate your repositories and pull requests from Server or Data Center to Bitbucket Cloud. The migration assistant is built and maintained by Atlassian and free to install and use.

Any active users in your Bitbucket Server or Data Center instance are also migrated to your Bitbucket Cloud workspace, where you can go to access them and provide the proper permissions and settings across your workflows.

Learn more about using the Bitbucket Cloud Migration Assistant

Benefits	Limitations
Choose what projects and repositories you want to migrate Be guided through the migration with an easy-to-use interface Identify any problems with your data before you migrate Migrate in phases if needed	You must be using version 7.0 or later of Bitbucket Server to install and use the Bitbucket Cloud Migration Assistant Repository size limit: 4GB User permissions and group memberships are not migrated Any apps and integrations are not migrated at this time. Project settings and permissions are not migrated. We're currently working on implementing project settings and permissions in Bitbucket Cloud. See our Cloud Roadmap Branch permissions aren’t migrated Pull request attachments (such as images and videos) are not migrated We are actively working on implementing some of these limitations into the Bitbucket Cloud Migration Assistant.

Benefits

Limitations

Choose what projects and repositories you want to migrate
Be guided through the migration with an easy-to-use interface
Identify any problems with your data before you migrate
Migrate in phases if needed

You must be using version 7.0 or later of Bitbucket Server to install and use the Bitbucket Cloud Migration Assistant
Repository size limit: 4GB
User permissions and group memberships are not migrated
Any apps and integrations are not migrated at this time.
Project settings and permissions are not migrated. We're currently working on implementing project settings and permissions in Bitbucket Cloud. See our Cloud Roadmap
Branch permissions aren’t migrated
Pull request attachments (such as images and videos) are not migrated

We are actively working on implementing some of these limitations into the Bitbucket Cloud Migration Assistant.

Plan your migration

When you’re ready for the next step, plan your Bitbucket Server/Data Center to Cloud migration by reviewing and completing the steps from the Bitbucket pre-migration checklist.

Learn more about the Bitbucket pre-migration checklist

More information and support

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.
For more help, check out the Cloud migration guide or register for our Cloud migration demos with live chat Q&A.

Was this helpful?

It wasn't accurate

It wasn't clear

It wasn't relevant

Still need help?

The Atlassian Community is here for you.

Ask the Community