Migration playbook · Bitbucket

How to migrate Bitbucket Server or Data Center to Bitbucket Cloud

Move Git repositories and pull requests from Bitbucket Server or Data Center to Bitbucket Cloud with Atlassian's free migration assistant, then rebuild what it leaves behind: Git LFS files, webhooks, default reviewers, merge checks and CI.

Checked against vendor documentation – 20 November 20265 phases15 detailed steps9 official sources
Start here

Which route should you take for migrating Bitbucket Server or Data Center to Bitbucket Cloud?

Short answer

This moves Git repositories and pull requests from Bitbucket Server or Data Center to Bitbucket Cloud. The migration assistant copies repositories in waves while each wave is frozen, then you finish what it does not move: large files stored in Git LFS, webhooks, default reviewers, merge checks, apps and builds.

  • Recommended route: Bitbucket Cloud Migration Assistant
  • Order: Decide the destination and workspace first, prove the assistant on a test migration, then move repositories in waves, finishing each wave's LFS, webhooks, reviewers and builds before developers switch.
  • 5 phases: Decide and plan, Install and test, Migrate production, Rebuild settings and integrations and Switch and retire the server.
  • You're done when: Branch, tag and commit counts match, and the default branch head is the same commit on both sides.
Key dates
  • Data Center subscriptions no longer sold to new customers.Passed
  • Last date for existing customers to buy new Data Center licences and expansions.Upcoming
  • Data Center licences expire and become read-only, unless you move to the Bitbucket Hybrid License.Upcoming

A test migration shows how long each repository takes, and reconnecting CI and Jira is its own piece of work.

Recommended routeBitbucket Cloud Migration Assistant

Free, built and maintained by Atlassian, and the method Atlassian recommends for repositories and pull requests.

Other options and when to use them
  • Bitbucket Hybrid License (stay on Data Center for now): You are an existing Bitbucket Data Center or Server customer and need to keep self-managed repositories past March 2029.
  • GitHub Enterprise Importer: Your destination is GitHub Enterprise Cloud rather than Bitbucket Cloud. It moves repositories and pull requests; CI pipelines stay in Bitbucket.
  • git push --mirror (code only): A handful of repositories where pull request history is not needed.
Order to migrate in, and why

Decide the destination and workspace first, prove the assistant on a test migration, then move repositories in waves, finishing each wave's LFS, webhooks, reviewers and builds before developers switch. The server is made read-only last.

  1. Destination decision: Bitbucket Cloud, Hybrid License or another platformDecides the tool, the timeline and whether CI has to move at all.
  2. Inventory: repository sizes, LFS use, forks, personal repositories, webhooks, builds and appsEach of these is handled outside the assistant, and oversized repositories fail its preflight checks.
  3. Cloud workspace on Standard or Premium, with users and email addresses cleaned upThe assistant refuses a Free plan and the personal default workspace, and users are matched by valid, unique email.
  4. Test migration of a few representative repositoriesShows timings, flattened pull request comments and preflight warnings before any freeze.
  5. Production waves of repositories that build togetherA stopped migration has to start again, so waves are sized to finish inside a freeze window.
  6. Per wave: LFS files, default reviewers, branch permissions, merge checks, webhooksWithout these, builds fail and the default branch has no protection on day one.
  7. CI and Jira reconnected, then developers switch remotesBuilds and Jira links point at the server until you change them.
  8. Server read-only, then retiredKeeps old links working and gives you a fallback until every build runs from Cloud.
Settings checklist: decide these before you copy

Built-in and third-party tools treat these differently. Tick each one off once you have decided.

Download this checklist (Excel)
  • How each tool handles it
    Built-in methodAtlassian: Data Center licences expire and become read-only on 28 March 2029. Existing Bitbucket and Bamboo Data Center customers can buy the Bitbucket Hybrid License, which covers self-managed Data Center and Bitbucket Cloud with Pipelines, available from early 2027.

    Tip: Make this decision before any inventory work: it changes the tool, the CI workstream and the deadline. If GitHub is the destination, GitHub Enterprise Importer moves repositories and pull requests from Bitbucket Server to GitHub Enterprise Cloud.

    Atlassian: Bitbucket Hybrid License
  • How each tool handles it
    Built-in methodAssistant: Bitbucket Server or Data Center 7.0 or later, and a Bitbucket Cloud workspace on the Standard or Premium plan. Atlassian says to use a workspace you created, not the default workspace named after your user account, which has limited functionality.

    Tip: Create the workspace early and name it for the organisation, not a person.

    Atlassian Support: Use the Bitbucket Cloud Migration Assistant
  • How each tool handles it
    Built-in methodAssistant: preflight checks block repositories over the Cloud size limit. Atlassian's pages give different figures: the migration methods page says 4 GB, and the what-gets-migrated page says the maximum is currently 10 GB. Treat the preflight result as the deciding check.

    Tip: Run a test migration with your largest repositories first, and read the size warnings in the preflight checks.

    Atlassian Support: What gets migrated with the Bitbucket Cloud Migration Assistant
  • How each tool handles it
    Built-in methodAssistant: LFS content is not migrated. Atlassian documents a separate mirror-clone and git lfs push procedure after the repository is migrated.

    Tip: Find LFS repositories by looking for filter=lfs in .gitattributes, and add the push to each wave's runsheet.

    Atlassian Support: Migrating repositories containing LFS to Bitbucket Cloud
  • How each tool handles it
    Built-in methodAssistant: pull request titles, descriptions, status, diffs, comments, tasks, authors and reviewers migrate. Atlassian says comments and tasks are flattened and may not display as they did on Server. Pull request attachments and the activity feed do not migrate.

    Tip: In the test migration, ask owners to compare a few busy pull requests on both sides.

    Atlassian Support: What gets migrated with the Bitbucket Cloud Migration Assistant
  • How each tool handles it
    Built-in methodAssistant: forks arrive as normal repositories with the fork link lost, so Atlassian recommends merging open pull requests from forks first. Personal repositories and repositories with duplicate names are not migrated; Atlassian suggests moving personal repositories into normal projects first.

    Tip: Move personal repositories that matter into a project, and rename duplicates, before the test migration.

    Atlassian Support: What gets migrated with the Bitbucket Cloud Migration Assistant
  • How each tool handles it
    Built-in methodAssistant: you choose all users, users with access to or involved in pull requests, or only those involved in pull requests. Groups, permissions, branch permissions and branching models can be migrated only into workspaces administered through Atlassian Administration. Atlassian's methods and after-migration pages still say permissions need recreating, so check the options your workspace shows. Inactive users arrive with no permissions, and avatars, passwords, SSH keys and app passwords never migrate.

    Tip: Export the current permission list from the server before the first wave, so you can rebuild or check it the same day.

    Atlassian Support: Use the Bitbucket Cloud Migration Assistant
  • How each tool handles it
    Built-in methodAssistant: default reviewers, webhooks, merge checks, build statuses, project settings and Marketplace apps with their data are not migrated. Atlassian lists each as a manual step after migration.

    Tip: Export each repository's webhooks and merge checks from the server, and recreate them straight after each wave.

    Atlassian Support: After migrating to Bitbucket Cloud
  • How each tool handles it
    Built-in methodAssistant: Atlassian's migration pages do not cover CI, and build statuses are not migrated. Any build server that clones from the Bitbucket server keeps doing so until you change it.

    Tip: List every build job, deploy key and script that clones from the server, and give each repository a CI owner in the wave plan.

    Atlassian Support: After migrating to Bitbucket Cloud
  • How each tool handles it
    Built-in methodAssistant: Atlassian asks people to avoid changing anything during the transition and suggests locking down the server. Stopping a migration means starting again, and already-migrated repositories should be deleted first to avoid Invalid repository errors. Run only one migration at a time.

    Tip: Size each wave to finish well inside its window, and keep a list of what has already landed in Cloud.

    Atlassian Support: Bitbucket pre-migration checklist
The plan, phase by phase
  1. 1

    Decide and plan

    Before you start

    Watch out: Atlassian's pages give different repository size limits (4 GB on the methods page, 10 GB on the what-gets-migrated page).

    Ways around it

    • Use the preflight check result for each repository, and test the largest ones first.
    Show the detailed steps (3) →
  2. 2

    Install and test

    Watch out: Pull request comments and tasks are flattened and may not display as they did on Server.

    Ways around it

    • Show owners examples in the test site and agree it is acceptable before production.
    Show the detailed steps (3) →
  3. 3

    Migrate production

    In each wave's freeze window

    Watch out: Stopping a migration means starting again, and only one migration should run at a time.

    Ways around it

    • Delete repositories that already landed before rerunning, unless they have not changed.
    Show the detailed steps (3) →
  4. 4

    Rebuild settings and integrations

    Watch out: Webhooks, default reviewers, merge checks, build statuses and Marketplace apps are not migrated.

    Ways around it

    • Export them per repository from the server before the wave, and recreate them before developers switch.
    Show the detailed steps (3) →
  5. 5

    Switch and retire the server

    Watch out: Uninstalling or deleting the server cannot be undone, and anything the assistant did not move goes with it.

    Ways around it

    • Keep the server read-only until every build runs from Cloud and the decommission checklist is signed off.

    Turn this phase into dated tasks with the cutover planner

    Show the detailed steps (2) →
You are finished when
  • Branch, tag and commit counts match, and the default branch head is the same commit on both sides.
  • Pull request counts match, and LFS files download with their content.
  • Each repository has its default reviewers, branch permissions, merge checks and webhooks.
  • Every build runs from Bitbucket Cloud, and nothing has been pushed to the server since the freeze.
Click by click

What does each step of migrating Bitbucket Server or Data Center to Bitbucket Cloud involve?

Open a part when you reach it in the plan. Each step says where to go, what to do and what you should see.

About this migrationWhat it covers, limits at a glance

Atlassian's Bitbucket Cloud Migration Assistant copies repositories and pull requests from Bitbucket Server or Data Center into a Bitbucket Cloud workspace. It does not move Git LFS files, webhooks, default reviewers, merge checks, apps or build configuration, so a Bitbucket move is a source-control project with a CI and integrations workstream, not only a copy.

Atlassian has set 28 March 2029 as the end of life for its Data Center products, when licences expire and become read-only. For Bitbucket there is a third option: the Bitbucket Hybrid License, which Atlassian says will cover both Bitbucket Data Center and Bitbucket Cloud from early 2027. If you are moving Jira and Confluence too, run this alongside the Jira and Confluence Server to Cloud playbook. If GitHub is the destination, see the GitLab to GitHub and Azure DevOps to GitHub playbooks, which use the same importer family.

Native toolBitbucket Cloud Migration Assistant, free from the Atlassian Marketplace
SourceBitbucket Server or Data Center 7.0 or later
DestinationA Bitbucket Cloud workspace on the Standard or Premium plan
MigratedRepositories (branches, tags, commits), pull requests with comments and tasks, and the users you choose
Not migratedGit LFS files, forks as forks, webhooks, default reviewers, merge checks, Marketplace apps, SSH keys
DeadlineAtlassian Data Center end of life on 28 March 2029, unless you move to the Bitbucket Hybrid License
1What do you need before you migrate Bitbucket Server or Data Center to Bitbucket Cloud?
NeedDetailsWhere to get it
Bitbucket Server or Data Center 7.0 or laterOlder versions must be upgraded before the assistant can run.Bitbucket administration > About
Bitbucket Cloud workspaceStandard or Premium plan, created for the organisation, not the default personal workspace.bitbucket.org; check current plans with Atlassian
Admin accessSystem administrator on the server, and admin of the Cloud workspace.Your Atlassian administrators
NetworkThe server must reach atlassian.com if it is behind a firewall.Your network team
Git LFS clientNeeded on the migration machine for repositories that use LFS.https://git-lfs.com
InventoryEvery repository with size, LFS use, forks, webhooks, builds and owner.Application inventory and dependency map template
2Decide the destination and plan the waves3 steps
Bitbucket itemMoves with the assistant?What to do
Branches, tags, commitsYesCheck size against the preflight result
Pull requests with comments, tasks and reviewersYes (comments and tasks flattened)Merge or decline stale pull requests first
UsersYes, by the option you chooseFix email addresses first
Groups, permissions, branch permissionsOnly into Atlassian-administered workspacesOtherwise recreate after each wave
Git LFS filesNoPush separately (Step 4)
ForksAs normal repositories, link lostMerge open pull requests from forks first
Personal repositories, duplicate namesNoMove into projects or rename first
Default reviewers, webhooks, merge checks, build statusesNoRecreate (Step 5)
Marketplace apps and their dataNoInstall Cloud versions where they exist
Avatars, passwords, SSH keys, app passwordsNoUsers set them up again in Cloud
  1. 1

    Record the destination decision

    Where: Your project brief, signed off by engineering leads

    Write down whether you are moving to Bitbucket Cloud, staying self-managed under the Bitbucket Hybrid License, or moving to another platform, and why.

    You should see: A signed-off decision and a target date before 28 March 2029.
  2. 2

    Inventory the repositories

    Where: Bitbucket administration on the server, and your Application inventory and dependency map

    List every project and repository with its size, owner, whether it uses Git LFS, its forks, webhooks, merge checks, default reviewers and the build jobs that clone it. Mark personal repositories and duplicate names.

    You should see: One row per repository with these flags, an owner and a wave.
  3. 3

    Set the waves and freeze windows

    Where: Your Migration wave plan

    Group repositories that build together into the same wave, give each wave a test date and a production freeze window, and name a CI owner for each repository.

    You should see: The wave plan is signed off by each team lead.
3Install the assistant and run a test migration3 steps
  1. 1

    Install the migration assistant

    Where: Bitbucket Data Center or Server administration > Manage apps, with the app from the Atlassian Marketplace

    Install the Bitbucket Cloud Migration Assistant. If the server is behind a firewall, allow it to reach atlassian.com.

    You should see: Administration shows a Migrate to cloud item.
  2. 2

    Connect to the Cloud workspace

    Where: Bitbucket Data Center or Server: Administration > Migrate to cloud (the migration assistant) > Manage your migration > Create a new migration > Connect to cloud

    Name the migration plan and select I already have a workspace. Copy the Base URL from Administration > Server settings into Migration from, choose the workspace under Migrate to, tick Allow Atlassian to access migration data and select Confirm.

    You should see: The plan shows your server as the source and your workspace as the destination.
  3. 3

    Migrate a few representative repositories

    Where: Bitbucket Data Center or Server: Administration > Migrate to cloud (the migration assistant)

    Choose a small, a large and a busy repository, select Add to migration, pick the user, group and permission options, then run the preflight checks and the migration. Compare the results with each owner and record how long it took.

    You should see: The test repositories appear in the workspace, and each owner signs off the comparison in your Pilot test plan.
4Migrate production repositories3 steps
  1. 1

    Freeze the wave

    Where: Bitbucket repository and project permissions on the server

    Merge or decline open pull requests, especially from forks. At the start of the window, remove write access for the wave's repositories and tell developers the freeze has started.

    You should see: Pushes to the wave's repositories are refused.
  2. 2

    Create the migration and run preflight checks

    Where: Bitbucket Data Center or Server: Administration > Migrate to cloud (the migration assistant) > Create a new migration

    Select the wave's repositories, choose users, groups, permissions and branch permissions, and run the preflight checks. A red error blocks the migration; a warning lets you continue. Fix errors, then use Refresh all.

    You should see: Every check is green, or shows only warnings you have accepted.
  3. 3

    Run and monitor

    Where: Bitbucket Data Center or Server: Administration > Migrate to cloud (the migration assistant) > Review migration > Run

    Select Run and watch the details screen. Run one migration at a time. If it finishes with errors, check the workspace for what arrived; if it fails, create a new migration that avoids the cause.

    You should see: The migration completes and Go to cloud workspace shows the wave's repositories.
5Push Git LFS files1 step
  1. 1

    Push LFS objects to each Cloud repository

    Where: Terminal on your migration machine with Git LFS installed and SSH access to the server

    For each repository that uses LFS, mirror-clone it from the server, fetch every LFS object, point LFS at the Cloud repository and push. This follows Atlassian's LFS migration article.

    git clone --mirror ssh://git@bitbucket.contoso.com:7999/PAY/payments-api.git
    cd payments-api.git
    git lfs install --local
    git lfs fetch --all
    git config lfs.url https://bitbucket.org/contoso/payments-api.git/info/lfs
    git remote set-url origin https://bitbucket.org/contoso/payments-api.git
    git lfs push --all https://bitbucket.org/contoso/payments-api.git
    You should see: A fresh clone from Bitbucket Cloud downloads LFS files with their content, not pointer files.
6Rebuild settings, integrations and builds3 steps
  1. 1

    Recreate reviewers, permissions and merge checks

    Where: Bitbucket Cloud > each repository > Repository settings

    Add default reviewers, recreate branch permissions if they were not migrated, set merge checks, and give groups their repository access.

    You should see: The default branch rejects direct pushes from developers, and pull requests show the right reviewers.
  2. 2

    Recreate webhooks and apps, and connect Jira

    Where: Bitbucket Cloud > Repository settings > Webhooks, workspace settings for apps, and your Jira site

    Recreate each webhook from your export, install Cloud versions of the apps you need, and connect Bitbucket Cloud to Jira using the guide for your Jira deployment.

    You should see: Each webhook shows a successful test delivery, and Jira work items show their branches and commits.
  3. 3

    Point builds and deployments at Cloud

    Where: Your CI server (Jenkins, Bamboo or other) or Bitbucket Pipelines

    Change each build job and deployment script to clone from bitbucket.org, with new access keys or tokens. Keep the server read-only until every build is green.

    You should see: Every repository builds from Bitbucket Cloud, and no job still clones from the server.
7Switch developers and retire the server2 steps
  1. 1

    Point local clones at Bitbucket Cloud

    Where: Each developer's terminal, inside their existing clone

    Developers add their SSH key in Bitbucket Cloud, change the remote URL and fetch to confirm. SSH keys and app passwords do not migrate.

    git remote set-url origin git@bitbucket.org:contoso/payments-api.git
    git fetch origin
    git remote -v
    You should see: git remote -v shows bitbucket.org and git fetch succeeds.
  2. 2

    Keep the server read-only, then retire it

    Where: Bitbucket administration on the server, and your Decommission checklist

    Leave the server read-only for an agreed period so links in tickets and documents still resolve. Export what your records policy requires, then decommission it.

    You should see: The decommission checklist is signed off and nothing still clones from the server.
Worth knowing

What can go wrong when migrating Bitbucket Server or Data Center to Bitbucket Cloud, and how do you avoid it?

The detail behind the plan: options compared, and what experienced engineers check first. Tap any item.

Compare all the ways to do this3 options

Bitbucket Cloud Migration Assistant

Medium effort

Best for: Moving to Bitbucket Cloud with pull request history

  • Free and maintained by Atlassian
  • Moves repositories, pull requests and chosen users
  • Preflight checks catch blockers before the run
  • No Git LFS files, webhooks, default reviewers, merge checks or apps
  • A stopped migration starts again
  • One migration at a time
Read more →

Bitbucket Hybrid License

Low effort

Best for: Existing Bitbucket Data Center customers who need to stay self-managed past March 2029

  • Keeps self-managed repositories
  • Adds Bitbucket Cloud with Pipelines under one subscription
  • Only for existing Bitbucket and Bamboo Data Center or Server customers
  • Available from early 2027
Read more →

GitHub Enterprise Importer

Medium effort

Best for: Organisations standardising on GitHub Enterprise Cloud

  • Moves Git repositories and pull requests
  • Same importer family as GitLab and Azure DevOps moves
  • CI pipelines stay in Bitbucket
  • Permissions rebuilt as teams; user activity attributed to placeholders until reclaimed
Read more →
Our advice

Use the migration assistant when Bitbucket Cloud is the destination and pull request history matters. Look at the Hybrid License first if your teams need self-managed repositories after March 2029. If the organisation is standardising on GitHub, use GitHub Enterprise Importer instead. Whichever you choose, plan Git LFS, integrations and CI as their own workstream.

Decide the destination before anything elseCost lever

Atlassian has set Data Center end of life for 28 March 2029, when licences expire and become read-only. For Bitbucket, it also offers a Hybrid License to existing Bitbucket and Bamboo Data Center customers that covers both self-managed and Cloud, from early 2027.

What to do

Choose between Bitbucket Cloud, the Hybrid License and another platform with your engineering leads, and record it in the plan. The rest of this playbook assumes Bitbucket Cloud.

Atlassian: Bitbucket Hybrid License
Push Git LFS files separatelyReduces risk

Atlassian says the assistant migrates repository source, branches, tags, pull requests and users, but not LFS files. A repository that looks complete fails its first build when they are missing.

What to do

List repositories with filter=lfs in .gitattributes, and run the LFS push in Step 4 straight after each one migrates.

Atlassian Support: Migrating repositories containing LFS
Freeze each wave; a stopped migration starts againReduces risk

Atlassian asks people not to change anything during the transition. If you stop a migration, you start over, and repositories that already landed should be deleted first.

What to do

Agree a freeze window per wave, lock the repositories at the start, and run one migration at a time.

Atlassian Support: Use the Bitbucket Cloud Migration Assistant
Plan CI as its own workstreamSaves time

Atlassian's migration pages do not cover CI, and build statuses are not migrated. Every Jenkins, Bamboo or deployment job that clones from the server keeps pointing there.

What to do

List build jobs, deploy keys and scripts per repository, decide where each will run, and keep the server read-only, not deleted, until every build runs from Cloud.

Atlassian Support: After migrating to Bitbucket Cloud
Recreate repository settings before developers switchCompliance

Default reviewers, branch permissions (unless migrated), webhooks and merge checks are manual steps after migration. Without them the default branch has no protection on day one.

What to do

Export each repository's settings from the server before its wave and recreate them in Step 5.

Atlassian Support: After migrating to Bitbucket Cloud
Clean up users and email addresses firstUser impact

The preflight checks look for unique, valid user email addresses. Users with invalid addresses can only come across as inactive users, with no permissions.

What to do

Fix blank, shared or duplicate email addresses on the server before the test migration.

Atlassian Support: Use the Bitbucket Cloud Migration Assistant
Finish safely

How do you check it worked after migrating Bitbucket Server or Data Center to Bitbucket Cloud, or roll back?

Full validation checklist6 checks

Run these before you declare the migration complete. Record the results in the data validation report.

CheckHow to checkWhat good looks like
Branches, tags and commits match

In a fresh clone from each side run git branch -r | wc -l, git tag | wc -l and git rev-list --all --count, and compare.

Counts are identical, and the default branch head is the same commit on the server and in Cloud.
Pull requests arrived

Compare open, merged and declined pull request counts per repository, and open a few busy ones with their owners.

Counts match, and sampled pull requests keep comments, tasks and reviewers.
LFS content is real

Clone from Bitbucket Cloud and run git lfs ls-files, then open a few of the files.

Files download with their content, not as text pointer files.
Settings and integrations are in place

Try a direct push to the default branch from a developer account, and send a test delivery from each webhook.

The push is rejected, each webhook shows a successful delivery, and Jira shows linked commits.
Builds run from Cloud

Trigger a build for each repository and check the clone URL in its log.

Every build is green and clones from bitbucket.org.
The server is no longer written to

Check the last push date on each migrated repository on the server.

No pushes after the freeze started.
Rollback planIf it goes wrong

Roll back if

  • The production run fails for key repositories and cannot be rerun inside the freeze window
  • Builds or deployments cannot run from Bitbucket Cloud and the server is still needed to ship
  • Pull request history is missing in a way the owners will not accept

Point of no return

The assistant copies from the server and leaves it in place, so until developers push to Cloud you can restore write access and carry on. Once people commit and merge in Cloud, that work exists only there and must be pushed back by hand. Decommissioning the server cannot be undone.

  1. 1

    Restore write access on the server

    Where: Bitbucket repository and project permissions on the server

    Give developers write access to the wave's repositories again and tell them to keep working on the server.

    You should see: Developers can push and open pull requests on the server.
  2. 2

    Push back any commits made in Cloud

    Where: Terminal on your migration machine

    For each repository where people pushed to Cloud, mirror-clone it from Cloud and push the new branches and tags to the server. Recreate any pull requests opened in Cloud.

    git clone --mirror https://bitbucket.org/contoso/payments-api.git
    cd payments-api.git
    git push --all ssh://git@bitbucket.contoso.com:7999/PAY/payments-api.git
    git push --tags ssh://git@bitbucket.contoso.com:7999/PAY/payments-api.git
    You should see: The server shows every branch and tag created in Cloud.
  3. 3

    Revert remotes and builds

    Where: Each developer's clone, and your CI settings

    Set each clone's origin back to the server URL with git remote set-url origin, and point build jobs back at the server.

    You should see: git remote -v shows the server and builds run from it again.

Agree the triggers and who decides before the go / no-go meeting. Use the rollback plan template.

Common problems and fixes6 errors
Preflight check fails: repository too large

Cause: The repository is over the Cloud size limit the preflight check applies.

Fix: Clean up history or move large files to Git LFS on the server, then rerun the checks.

Preflight check fails: plan or workspace

Cause: The workspace is on the Free plan, or it is the default personal workspace.

Fix: Use a workspace you created, on the Standard or Premium plan.

Invalid repository error when rerunning

Cause: Repositories from a stopped or failed run are already in the workspace.

Fix: Delete the repositories that already landed (unless unchanged), then create a new migration.

Users arrive as inactive with no permissions

Cause: Their email addresses were invalid, so they were migrated as inactive users.

Fix: Fix the addresses, then give the users access in Cloud.

Build fails after migration: LFS files are pointers

Cause: LFS files are not migrated by the assistant.

Fix: Run the LFS push in Step 4 for that repository.

Fork link missing

Cause: Forks are migrated as normal repositories.

Fix: Merge open pull requests from forks before migrating; recreate any forks you still need.

Search the full error library →

FAQ

Questions about migrating Bitbucket Server or Data Center to Bitbucket Cloud

Is Bitbucket Data Center going away?

Atlassian has set 28 March 2029 as Data Center end of life, when licences expire and become read-only. Existing Bitbucket customers can instead buy the Bitbucket Hybrid License, which Atlassian says covers Data Center and Bitbucket Cloud from early 2027.

Does the migration assistant move pull requests?

Yes. Titles, descriptions, status, diffs, comments, tasks, authors and reviewers migrate. Comments and tasks are flattened, and pull request attachments and the activity feed do not migrate.

Are Git LFS files migrated?

No. Atlassian documents a separate mirror-clone and git lfs push after the repository is migrated.

Are permissions migrated?

Groups, permissions and branch permissions can be migrated only into workspaces administered through Atlassian Administration. Otherwise recreate them after each wave.

Do Jenkins or Bamboo builds move?

No. Atlassian's migration pages do not cover CI, and build statuses are not migrated. Point each build job at the Cloud repository, or move it to Bitbucket Pipelines.

Can I move Bitbucket Server to GitHub instead?

Yes. GitHub Enterprise Importer migrates Git repositories and pull requests from Bitbucket Server to GitHub Enterprise Cloud. CI pipelines stay in Bitbucket, and permissions are recreated as GitHub teams.

Sources

Official sources for migrating Bitbucket Server or Data Center to Bitbucket Cloud

9 official pages this guide is based on

Get one practical migration tip a day

Follow Cloud-Migrations.au on LinkedIn or X for deadlines, error fixes, free templates and outage briefs as they happen.