• Products
  • Documentation
  • Resources

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.



  • 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. For more information on connecting your Jira instance to Bitbucket Cloud, refer to the following help docs:

  • 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.

When you’re ready for the next step, plan your Bitbucket Server to Cloud migration.

More information and support

We have a number of channels available to help you with your migration.

Additional Help