Guide to Migrating Repositories Containing LFS from Bitbucket Data Center to Bitbucket Cloud

Summary

This document provides step-by-step instructions for migrating large repositories from a server to the cloud using Bitbucket. The process involves using the migration assistant tool, handling Git LFS objects, and executing mirror clones to ensure a seamless and successful migration.

Solution

Step 1: Install the Migration Assistant Tool (BCMA) and select the repository (or repositories) with LFS files for migration to Bitbucket Cloud. BCMA will handle the repository source, branches, tags, pull requests, and users but will not migrate the LFS files. To migrate the LFS files separately, follow the next steps.

Step 2: After the repository migration, perform a mirror clone of the migrated repository from Bitbucket Server, for example:

Step 3: Install Git LFS Locally

Step 5: Fetch all the LFS objects using the command:

Step 6: Check the LFS environment with:

Configure the LFS URL to point to the Bitbucket Cloud repository:

Step 7: Set the remote URL of the origin to the Bitbucket Cloud repository using the following command (replace the URL with the correct one):

Step 8: Push all the LFS objects to the Bitbucket Cloud repository:

We have outlined the complete process to migrate large repositories from a server to the cloud, ensuring a seamless transition while managing large files using Git LFS. If you encounter any issues during the migration, feel free to seek assistance from the Bitbucket support team.