If you're moving between products, such as from Enterprise Server to Enterprise Cloud, or from another code hosting platform, such as Bitbucket Server or GitLab, to , you'll want to bring your work with you: your code, the code's history, and all of your past conversations and collaboration.
To plan for your migration, consider the destination and source. These considerations determine the path for your migration. For some migration paths, we offer specialist tools that allow you to migrate source, history, and metadata. For others, you'll need to perform a simpler "source and history" or "source snapshot" migration.
Some migration paths require tools that are only available with expert-led migrations. For more information, contact your account manager on 's Sales team or see the Expert Services website.
In our recommendations, we'll assume that you want the highest level of fidelity if possible, which includes source, history, and metadata.
Nota:
Enterprise Cloud Importer (ECI) and the GraphQL endpoints for importing migration data to Enterprise Cloud from an archive are closing down on March 31, 2025. After this date, these tools can not be used to import repository data into 's cloud-based products. We recommend using Enterprise Importer (GEI). See About Enterprise Importer.
You can review the scope and tooling for your migration to .com, which includes migrations to Enterprise Cloud. You can also review any additional information or caveats.
- Enterprise Server 3.4.1 or newer to .com
- Enterprise Server 3.4.0 or older to .com
- .com to .com
- Azure DevOps Services (Azure DevOps Cloud) to .com
- Azure DevOps Server to .com
- Bitbucket Cloud (Bitbucket.org) to .com
- Bitbucket Server or Bitbucket Data Center to .com
- GitLab to .com
- Any Git repository to .com
- Any Mercurial repository to .com
- Any Subversion (SVN) repository to .com
- Any Team Foundation Version Control (TFVC) repository to .com
- Any Perforce repository to .com
- Any other repository to .com
- GHE.com to .com
- Scope: Source, history, and metadata
- Tooling: Enterprise Importer
- More information:
- Caveats:
- For repositories with git or metadata archives greater than 40GB, consider engaging our Expert Services to help bring your large repositories within Enterprise Cloud Importer limits.
- If an expert-led migration isn't right for you, you can perform a "source and history" migration of the affected repositories instead. For more information, see Migrations from any Git repository to .com.
- Scope: Source, history, and metadata
- Tooling: Enterprise Importer
- More information:
- Caveats:
- For repositories with git or metadata archives greater than 40GB, consider engaging our Expert Services to help bring your large repositories within Enterprise Cloud Importer limits.
- If an expert-led migration isn't right for you, you can perform a "source and history" migration of the affected repositories instead. For more information, see Migrations from any Git repository to .com.
Migrations from .com include Enterprise Cloud. This path includes adoption of Enterprise Managed Users or a move between managed enterprises.
- Scope: Source, history, and metadata
- Tooling: Enterprise Importer or Expert Services
- More information:
- Caveats:
- For repositories with git or metadata archives greater than 40GB, consider engaging our Expert Services to help bring your large repositories within Enterprise Cloud Importer limits.
- If an expert-led migration isn't right for you, you can perform a "source and history" migration of the affected repositories instead. For more information, see Migrations from any Git repository to .com.
- Scope: Source, history, and metadata
- Tooling: Enterprise Importer
- More information: Using Enterprise Importer
- Scope: Source, history, and metadata
- Tooling: Migration to Azure DevOps Services, then Enterprise Importer
- More information:
- Migrate data from Azure DevOps Server to Azure DevOps Services in the Microsoft Docs
- Using Enterprise Importer
- Caveats: If you can't migrate to Azure DevOps Services first, you must perform a "source and history" migration instead. For more information, Migrations from any Git repository to .com.
- Scope: Source and history
- Tooling: Git CLI or Importer
- More information:
- Scope: Source, history, and metadata
- Tooling: Enterprise Importer
- More information:
- Caveats:
- For repositories with git or metadata archives greater than 40GB, consider engaging our Expert Services to help bring your large repositories within Enterprise Cloud Importer limits.
- If an expert-led migration isn't right for you, you can perform a "source and history" migration of the affected repositories instead. For more information, see Migrations from any Git repository to .com.
- Scope: Source, history, and metadata
- Tooling: Enterprise Importer
- More information: Expert Services website
- Caveats:
- If you want to migrate GitLab repositories to using Enterprise Importer, please contact our Expert Services team.
- If an expert-led migration isn't right for you, you can perform a "source and history" migration of the affected repositories instead. For more information, see Migrations from any Git repository to .com.
- Scope: Source and history
- Tooling: Git CLI or Importer if the repository is accessible over the public internet
- More information:
- Scope: Source and history
- Tooling: Mercurial, Git CLI, and Python
- More information: Importing a Mercurial repository
- Scope: Source and history
- Tooling: Subversion and Git CLI
- More information: Importing a Subversion repository
- Scope: Source and history
- Tooling: Azure Repos, then Git CLI
- More information: Importing a Team Foundation Version Control repository
- Scope: Source and history
- Tooling:
git-p4
, then Git CLI - More information:
- git-p4 in the Git documentation
- Adding locally hosted code to
- Scope: Source snapshot
- Tooling: CLI or Git CLI
- More information: Adding locally hosted code to
This path is not currently supported with our official tools. Please contact Expert Services.
If you're migrating to Enterprise Cloud with data residency, your migration destination is GHE.com.
Migrations to GHE.com use similar tools as migrations to .com. However, the Importer is not available.
Follow a link below to review the scope and tooling for your migration to GHE.com, plus any additional information or caveats.
- Enterprise Server 3.4.1 or newer to GHE.com
- Enterprise Server 3.4.0 or older to GHE.com
- .com to GHE.com
- Azure DevOps Services (Azure DevOps Cloud) to GHE.com
- Azure DevOps Server to GHE.com
- Bitbucket Cloud (Bitbucket.org) to GHE.com
- Bitbucket Server or Bitbucket Data Center to GHE.com
- GitLab to GHE.com
- Any Git repository to GHE.com
- Any Mercurial repository to GHE.com
- Any Subversion (SVN) repository to GHE.com
- Any Team Foundation Version Control (TFVC) repository to GHE.com
- Any Perforce repository to GHE.com
- Any other repository to GHE.com
- Scope: Source, history, and metadata
- Tooling: Enterprise Importer
- More information:
- Caveats:
- For complex repositories larger than around 40GB, we recommend contacting Expert Services.
- If an expert-led migration isn't right for you, you can perform a "source and history" migration of the affected repositories instead. For more information, see Migrations from any Git repository to GHE.com.
- Scope: Source, history, and metadata
- Tooling: Enterprise Importer
- More information:
- Caveats:
- For complex repositories larger than around 40GB, we recommend contacting Expert Services.
- If an expert-led migration isn't right for you, you can perform a "source and history" migration of the affected repositories instead. For more information, see Migrations from any Git repository to GHE.com.
- Scope: Source, history, and metadata
- Tooling: Enterprise Importer or Expert Services
- More information:
- Caveats:
- For complex repositories larger than around 40GB, we recommend contacting Expert Services.
- If an expert-led migration isn't right for you, you can perform a "source and history" migration of the affected repositories instead. For more information, see Migrations from any Git repository to GHE.com.
- Scope: Source, history, and metadata
- Tooling: Enterprise Importer
- More information: Using Enterprise Importer
- Scope: Source, history, and metadata
- Tooling: Migration to Azure DevOps Services, then Enterprise Importer
- More information:
- Migrate data from Azure DevOps Server to Azure DevOps Services in the Microsoft Docs
- Using Enterprise Importer
- Caveats: If you can't migrate to Azure DevOps Services first, you must perform a "source and history" migration instead. For more information, see Migrations from any Git repository to GHE.com.
- Scope: Source and history
- Tooling: Git CLI
- More information:
- Scope: Source, history, and metadata
- Tooling: Enterprise Importer
- More information:
- Caveats:
- For complex repositories larger than around 40GB, we recommend contacting Expert Services.
- If an expert-led migration isn't right for you, you can perform a "source and history" migration of the affected repositories instead. For more information, see Migrations from any Git repository to GHE.com.
- Scope: Source, history, and metadata
- Tooling: Contact Expert Services
- More information: Expert Services website
- Caveats:
- If an expert-led migration isn't right for you, you can perform a "source and history" migration of the affected repositories instead. For more information, see Migrations from any Git repository to GHE.com.
- Scope: Source and history
- Tooling: Git CLI
- More information:
- Scope: Source and history
- Tooling: Mercurial, Git CLI, and Python
- More information: Importing a Mercurial repository
- Scope: Source and history
- Tooling: Subversion and Git CLI
- More information: Importing a Subversion repository
- Scope: Source and history
- Tooling: Azure Repos, then Git CLI
- More information: Importing a Team Foundation Version Control repository
- Scope: Source and history
- Tooling:
git-p4
, then Git CLI - More information:
- git-p4 in the Git documentation
- Adding locally hosted code to
- Scope: Source snapshot
- Tooling: CLI or Git CLI
- More information: Adding locally hosted code to
You can review the scope and tooling for your migration to Enterprise Server, including any additional information or caveats.
- .com to Enterprise Server
- Enterprise Server to Enterprise Server
- Azure DevOps to Enterprise Server
- Bitbucket Cloud (Bitbucket.org) to Enterprise Server
- Bitbucket Server or Bitbucket Data Center to Enterprise Server
- GitLab to Enterprise Server
- Any Git repository to Enterprise Server
- Any Mercurial repository to Enterprise Server
- Any Subversion (SVN) repository to Enterprise Server
- Any Team Foundation Version Control (TFVC) repository to Enterprise Server
- Any Perforce repository to Enterprise Server
- Any other repository to Enterprise Server
- GHE.com to Enterprise Server
Migrations from .com include Enterprise Cloud.
- Scope: Source, history, and metadata
- Tooling: Organization migrations API, then
ghe-migrator
- More information:
- Scope: Source, history, and metadata
- Tooling: Organization migrations API, then
ghe-migrator
- More information:
- Scope: Source and history
- Tooling: Git CLI
- More information: Importing an external Git repository using the command line
- Scope: Source and history
- Tooling: Git CLI
- More information: Importing an external Git repository using the command line
- Scope: Source, history, and metadata
- Tooling:
bbs-exporter
(expert-led migrations only), thenghe-migrator
- More information:
- Caveats: If an expert-led migration isn't right for you, you can perform a "source and history" migration of the affected repositories instead. For more information, see Any Git repository to Enterprise Server.
- Scope: Source, history, and metadata
- Tooling:
gl-exporter
(expert-led migrations only), thenghe-migrator
- More information:
- Caveats: If an expert-led migration isn't right for you, you can perform a "source and history" migration of the affected repositories instead. For more information, see Any Git repository to Enterprise Server.
- Scope: Source and history
- Tooling: Git CLI
- More information: Importing an external Git repository using the command line
- Scope: Source and history
- Tooling: Mercurial, Git CLI, and Python
- More information: Importing a Mercurial repository
- Scope: Source and history
- Tooling: Subversion and Git CLI
- More information: Importing a Subversion repository
- Scope: Source and history
- Tooling: Azure Repos, then Git CLI
- More information: Importing a Team Foundation Version Control repository
- Scope: Source and history
- Tooling:
git-p4
, then Git CLI - More information:
- git-p4 in the Git documentation
- Adding locally hosted code to
- Scope: Source snapshot
- Tooling: CLI or Git CLI
- More information: Adding locally hosted code to
This path is not currently supported with our official tools. Please contact Expert Services.