How to migrate a Bitbucket Cloud workspace to another workspace.
Platform Notice: Cloud - This article applies to Atlassian products on the cloud platform.
Summary
This KB provides a step-by-step guide on migrating from one Bitbucket Cloud workspace to another.
Environment
Only applicable for Bitbucket cloud workspace to Bitbucket cloud workspace. Server please use Bitbucket Cloud Migration Assistant
Solution
Before starting, please communicate the migration plan with your team to ensure proper planning and execution.
Here is a step-by-step guide to help you migrate from one Bitbucket Cloud workspace to another:
1. Creating a new workspace
- Create a new Bitbucket workspace by following our guide at: How to create Bitbucket workspace
- Enter a unique name that is easy to remember for example; abcmigration
2. Transferring the repositories
- Click Repository settings in the left menu from the repository you want to transfer
- On the Repository details page, click Manage repository at the screen's top-right corner
- Click Transfer repository.
- Enter the Workspace ID as the above example abcmigration is the new workspace name ** to which you want to transfer the repository.
- Click Transfer.
Repeat these steps for all repositories you wish to migrate. Bitbucket will send an email to the new owner or workspace administrators containing the transfer request with a link to the page that allows the user to accept or reject the transfer.
3. Accepting the repositories transfer
If you receive a transfer request, accept it by doing the following:
Open the transfer request email.
Click the link provided to open the Transfer repository ownership screen. If you're not logged in to Bitbucket, you'll have to log in first.
If the repository is being transferred to a workspace, pick a project.
Click Accept.
Once you accept the request, the repository appears on your repositories list. Bitbucket updates all URLs on the server and the repository is accessible from its new location.
4. Post-migration
- You will require to re-invite everyone again to the new workspace and reconfigure the groups and their access to the repository manually. Please check our guide here on how to organize groups for your repositories.
- Update the local repository URL to the latest URL. Change the remote URL to your repository
If you are migrating from one workspace to another but wish to keep the workspace name and URL, rename the old workspace name to something else and update the new workspace name with the old name. This will allow you to continue using the old repository URL without updating it locally.