• Products
  • Documentation
  • Resources

What gets migrated with Bitbucket Cloud Migration Assistant

The Bitbucket Cloud Migration Assistant (BCMA) will add data to a Bitbucket Cloud workspace without overwriting any existing data. This means you can migrate data to a new or existing Bitbucket Cloud workspace. Not all data can be migrated using the Bitbucket Cloud Migration Assistant.

This page outlines what is and isn’t migrated with the migration assistant. To see what this means for your data, we recommend using the migration assistant’s pre-migration report to check what will be migrated. This can be found under the Review and Migrate section when building a new plan. It can also be found within the View Details of a saved plan under the View Errors and Warnings section.

What is migrated

What isn't migrated

Repository Git information

  • If your repository is part of a project in Server, then The Git repository (including all branches, tags, and commits) will be migrated to a new project with the server project name or added to a project of the same name that already exists in your cloud destination.

Pull request information

  • Title

  • Description

  • Pull request status (open, merged, declined)

  • Code diff, comments, tasks

  • Authors

  • Reviewers

Users

  • Choose which users you would like to migrate.

    • All users

    • Users with read access or who appear on selected repositories

    • Only users who appear on the selected repositories

 

Repository Git information

  • Migrating the link or association of forked repositories

    • NOTE: The forked repo can be migrated but it will lose its link or association and be treated as a normal repo if migrated. We recommend merging any open pull requests from forks prior to migrating to the cloud to prevent any data loss.

  • Content stored in Git LFS

    • NOTE: Git LFS can be migrated manually afterward. You will need to install and set up Git LFS on your repositories in Bitbucket Cloud. Learn more

  • Git submodules

    • NOTE: Specifically, the extra configuration within the code base (in a .gitsubmodules file) is not automatically updated. This file contains the links to other repos that will need to be updated by a customer/partner either before or after migrating.

  • Pull request attachments

  • Repos with duplicate names

  • Open changes on local machines

  • Extra large repos (max is currently 10GB)

  • Personal repos

    • NOTE: As a workaround, we recommend moving these to normal projects first so they can then be migrated.

  • Repo settings:

    • Add default reviewers

    • Branch permissions

    • Managing webhooks

    • Merge checks

    • Build statuses

User metadata

  • Groups

  • Permissions

  • Settings

  • Avatars

  • Passwords

  • Timezones

  • SSH keys

  • App passwords

Project data

  • Settings

  • Permissions

Apps and app data

  • App data is not included when migrating from Bitbucket Server to Bitbucket Cloud using BCMA. Some apps do have the capability to export and import their data (outside of BCMA scope) but you'll need to check with the app developers or their documentation to confirm if this is possible.

More information and support

To stay informed about the work being done on the migration assistant, keep an eye on our cloud migration roadmap.

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

Additional Help