How to migrate a Bitbucket Cloud workspace to another workspace
Platform Notice: Cloud Only - This article only 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
ClickRepository settingsin the left menu from the repository you want to transfer
On theRepository detailspage, clickManage repositoryat the screen's top-right corner
ClickTransfer repository.
Enter theWorkspace IDas the above exampleabcmigrationis 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 nameto 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.
Was this helpful?