---
title: Migration paths to GitHub
shortTitle: Migration paths
intro: 'See an overview of the paths available for migration to {% data variables.product.prodname_dotcom %} from other products, or between {% data variables.product.prodname_dotcom %} products.'
versions:
  fpt: '*'
  ghes: '*'
  ghec: '*'
  ghae: '*'
---

## About migration paths to GitHub

{% data reusables.migrations.about-migrations %}

{% data reusables.migrations.about-migration-paths %} 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 {% data variables.contact.contact_enterprise_sales %} or see the [{% data variables.product.prodname_expert_services %}](https://github.com/services/) website.

In our recommendations, we'll assume that you want the highest level of fidelity if possible, which includes source, history, and metadata.

## Migrations to {% data variables.product.prodname_dotcom_the_website %}

You can review the scope and tooling for your migration to {% data variables.product.prodname_dotcom_the_website %}, which includes migrations to {% data variables.product.prodname_ghe_cloud %}. You can also review any additional information or caveats.

- [{% data variables.product.prodname_ghe_server %} 3.4.1 or newer to {% data variables.product.prodname_dotcom_the_website %}](#github-enterprise-server-341-or-newer-to-githubcom)
- [{% data variables.product.prodname_ghe_server %} 3.4.0 or older to {% data variables.product.prodname_dotcom_the_website %}](#github-enterprise-server-340-or-older-to-githubcom)
- [{% data variables.product.prodname_dotcom_the_website %} to {% data variables.product.prodname_dotcom_the_website %}](#githubcom-to-githubcom)
- [Azure DevOps Services (Azure DevOps Cloud) to {% data variables.product.prodname_dotcom_the_website %}](#azure-devops-services-azure-devops-cloud-to-githubcom)
- [Azure DevOps Server to {% data variables.product.prodname_dotcom_the_website %}](#azure-devops-server-to-githubcom)
- [Bitbucket Cloud (Bitbucket.org-to-githubcom) to {% data variables.product.prodname_dotcom_the_website %}](#bitbucket-cloud-bitbucketorg-to-githubcom)
- [Bitbucket Server or Bitbucket Data Center to {% data variables.product.prodname_dotcom_the_website %}](#bitbucket-server-or-bitbucket-data-center-to-githubcom)
- [GitLab to {% data variables.product.prodname_dotcom_the_website %}](#gitlab-to-githubcom)
- [Any Git repository to {% data variables.product.prodname_dotcom_the_website %}](#any-git-repository-to-githubcom)
- [Any Mercurial repository to {% data variables.product.prodname_dotcom_the_website %}](#any-mercurial-repository-to-githubcom)
- [Any Subversion (SVN) repository to {% data variables.product.prodname_dotcom_the_website %}](#any-subversion-svn-repository-to-githubcom)
- [Any Team Foundation Version Control (TFVC) repository to {% data variables.product.prodname_dotcom_the_website %}](#any-team-foundation-version-control-tfvc-repository-to-githubcom)
- [Any Perforce repository to {% data variables.product.prodname_dotcom_the_website %}](#any-perforce-repository-to-githubcom)
- [Any other repository to {% data variables.product.prodname_dotcom_the_website %}](#any-other-repository-to-githubcom)

### {% data variables.product.prodname_ghe_server %} 3.4.1 or newer to {% data variables.product.prodname_dotcom_the_website %}

- **Scope**: Source, history, and metadata
- **Tooling**: {% data variables.product.prodname_importer_proper_name %}
- **More information**:
  - "[AUTOTITLE]({% ifversion ghae %}/free-pro-team@latest{% endif %}/migrations/using-github-enterprise-importer)"
  - [{% data variables.product.prodname_expert_services %}](https://github.com/services/) website
- **Caveats**:
  - {% data reusables.migrations.large-repositories-require-expert-services %}
  - {% data reusables.migrations.migration-instructions-for-any-git-repository-to-githubcom %}

### {% data variables.product.prodname_ghe_server %} 3.4.0 or older to {% data variables.product.prodname_dotcom_the_website %}

- **Scope**: Source, history, and metadata
- **Tooling**: {% data variables.product.prodname_importer_proper_name %}
- **More information**:
  - "[AUTOTITLE]({% ifversion ghae %}/free-pro-team@latest{% endif %}/migrations/using-github-enterprise-importer)"
  - [{% data variables.product.prodname_expert_services %}](https://github.com/services/) website
- **Caveats**:
  - {% data reusables.migrations.large-repositories-require-expert-services %}
  - {% data reusables.migrations.migration-instructions-for-any-git-repository-to-githubcom %}

### {% data variables.product.prodname_dotcom_the_website %} to {% data variables.product.prodname_dotcom_the_website %}

Migrations from {% data variables.product.prodname_dotcom_the_website %} include {% data variables.product.prodname_ghe_cloud %}. This path includes adoption of {% data variables.product.prodname_emus %} or a move between managed enterprises.

- **Scope**: Source, history, and metadata
- **Tooling**: {% data variables.product.prodname_importer_proper_name %} or {% data variables.product.prodname_expert_services %}
- **More information**:
  - "[AUTOTITLE]({% ifversion ghae %}/free-pro-team@latest{% endif %}/migrations/using-github-enterprise-importer)"
  - [{% data variables.product.prodname_expert_services %}](https://github.com/services/) website
- **Caveats**:
  - {% data reusables.migrations.large-repositories-require-expert-services %}
  - {% data reusables.migrations.migration-instructions-for-any-git-repository-to-githubcom %}

### Azure DevOps Services (Azure DevOps Cloud) to {% data variables.product.prodname_dotcom_the_website %}

- **Scope**: Source, history, and metadata
- **Tooling**: {% data variables.product.prodname_importer_proper_name %}
- **More information**: "[AUTOTITLE]({% ifversion ghae %}/free-pro-team@latest{% endif %}/migrations/using-github-enterprise-importer)"

### Azure DevOps Server to {% data variables.product.prodname_dotcom_the_website %}

- **Scope**: Source, history, and metadata
- **Tooling**: Migration to Azure DevOps Services, then {% data variables.product.prodname_importer_proper_name %}
- **More information**:
  - [Migrate data from Azure DevOps Server to Azure DevOps Services](https://learn.microsoft.com/en-us/azure/devops/migrate/migration-overview?view=azure-devops) in the Microsoft Docs
  - "[AUTOTITLE]({% ifversion ghae %}/free-pro-team@latest{% endif %}/migrations/using-github-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 {% data variables.product.prodname_dotcom_the_website %}](#migrations-from-any-git-repository)."

### Bitbucket Cloud (Bitbucket.org) to {% data variables.product.prodname_dotcom_the_website %}

- **Scope**: Source and history
- **Tooling**: Git CLI or GitHub Importer
- **More information**:
  - "[AUTOTITLE](/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-an-external-git-repository-using-the-command-line)"
  - "[AUTOTITLE]({% ifversion ghes %}/free-pro-team@latest{% endif %}/migrations/importing-source-code/using-github-importer/about-github-importer)"

### Bitbucket Server or Bitbucket Data Center to {% data variables.product.prodname_dotcom_the_website %}

- **Scope**: Source, history, and metadata
- **Tooling**: {% data variables.product.prodname_importer_proper_name %}
- **More information**:
  - "[AUTOTITLE]({% ifversion ghae %}/free-pro-team@latest{% endif %}/migrations/using-github-enterprise-importer)"
  - [{% data variables.product.prodname_expert_services %}](https://github.com/services/) website
- **Caveats**:
  - For complex repositories larger than around 5 GB, you may need to use `bbs-exporter` and Enterprise Cloud Importer instead. Enterprise Cloud Importer is only available for expert-led migrations.
  - {% data reusables.migrations.migration-instructions-for-any-git-repository-to-githubcom %}

### GitLab to {% data variables.product.prodname_dotcom_the_website %}

- **Scope**: Source, history, and metadata
- **Tooling**: `gl-exporter`, then Enterprise Cloud Importer (expert-led migrations only)
- **More information**: [{% data variables.product.prodname_expert_services %}](https://github.com/services/) website
- **Caveats**:
  - Enterprise Cloud Importer is only available for expert-led migrations.
  - {% data reusables.migrations.migration-instructions-for-any-git-repository-to-githubcom %}

### Any Git repository to {% data variables.product.prodname_dotcom_the_website %}

- **Scope**: Source and history
- **Tooling**: Git CLI or GitHub Importer if the repository is accessible over the public internet
- **More information**:
  - "[AUTOTITLE](/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-an-external-git-repository-using-the-command-line)"
  - "[AUTOTITLE]({% ifversion ghes %}/free-pro-team@latest{% endif %}/migrations/importing-source-code/using-github-importer/about-github-importer)"

### Any Mercurial repository to {% data variables.product.prodname_dotcom_the_website %}

- **Scope**: Source and history
- **Tooling**: Mercurial, Git CLI, and Python
- **More information**: "[AUTOTITLE](/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-a-mercurial-repository)"

### Any Subversion (SVN) repository to {% data variables.product.prodname_dotcom_the_website %}

- **Scope**: Source and history
- **Tooling**: Subversion and Git CLI
- **More information**: "[AUTOTITLE](/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-a-subversion-repository)"

### Any Team Foundation Version Control (TFVC) repository to {% data variables.product.prodname_dotcom_the_website %}

- **Scope**: Source and history
- **Tooling**: Azure Repos, then Git CLI
- **More information**: "[AUTOTITLE](/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-a-team-foundation-version-control-repository)"

### Any Perforce repository to {% data variables.product.prodname_dotcom_the_website %}

- **Scope**: Source and history
- **Tooling**: `git-p4`, then Git CLI
- **More information**:
  - [git-p4](https://git-scm.com/docs/git-p4) in the Git documentation
  - "[AUTOTITLE](/migrations/importing-source-code/using-the-command-line-to-import-source-code/adding-locally-hosted-code-to-github#importing-a-git-repository-with-the-command-line)"

### Any other repository to {% data variables.product.prodname_dotcom_the_website %}

- **Scope**: Source snapshot
- **Tooling**: {% data variables.product.prodname_cli %} or Git CLI
- **More information**: "[AUTOTITLE](/migrations/importing-source-code/using-the-command-line-to-import-source-code/adding-locally-hosted-code-to-github)"

## Migrations to {% data variables.product.prodname_ghe_server %}

You can review the scope and tooling for your migration to {% data variables.product.prodname_ghe_server %}, including any additional information or caveats.

- [{% data variables.product.prodname_dotcom_the_website %} to {% data variables.product.prodname_ghe_server %}](#githubcom-to-github-enterprise-server)
- [{% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_ghe_server %}](#github-enterprise-server-to-github-enterprise-server)
- [Azure DevOps to {% data variables.product.prodname_ghe_server %}](#azure-devops-to-github-enterprise-server)
- [Bitbucket Cloud (Bitbucket.org) to {% data variables.product.prodname_ghe_server %}](#bitbucket-cloud-bitbucketorg-to-github-enterprise-server)
- [Bitbucket Server or Bitbucket Data Center to {% data variables.product.prodname_ghe_server %}](#bitbucket-server-or-bitbucket-data-center-to-github-enterprise-server)
- [GitLab to {% data variables.product.prodname_ghe_server %}](#gitlab-to-github-enterprise-server)
- [Any Git repository to {% data variables.product.prodname_ghe_server %}](#any-git-repository-to-github-enterprise-server)
- [Any Mercurial repository to {% data variables.product.prodname_ghe_server %}](#any-mercurial-repository-to-github-enterprise-server)
- [Any Subversion (SVN) repository to {% data variables.product.prodname_ghe_server %}](#any-subversion-svn-repository-to-github-enterprise-server)
- [Any Team Foundation Version Control (TFVC) repository to {% data variables.product.prodname_ghe_server %}](#any-team-foundation-version-control-tfvc-repository-to-github-enterprise-server)
- [Any Perforce repository to {% data variables.product.prodname_ghe_server %}](#any-perforce-repository-to-github-enterprise-server)
- [Any other repository to {% data variables.product.prodname_ghe_server %}](#any-other-repository-to-github-enterprise-server)

### {% data variables.product.prodname_dotcom_the_website %} to {% data variables.product.prodname_ghe_server %}

Migrations from {% data variables.product.prodname_dotcom_the_website %} include {% data variables.product.prodname_ghe_cloud %}.

- **Scope**: Source, history, and metadata
- **Tooling**: Organization migrations API, then `ghe-migrator`
- **More information**:
  - "[AUTOTITLE](/enterprise-server/migrations/using-ghe-migrator/exporting-migration-data-from-githubcom)"
  - "[AUTOTITLE](/enterprise-server/migrations/using-ghe-migrator/migrating-data-to-github-enterprise-server)"

### {% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_ghe_server %}

- **Scope**: Source, history, and metadata
- **Tooling**: Organization migrations API, then `ghe-migrator`
- **More information**:
  - "[AUTOTITLE](/enterprise-server/migrations/using-ghe-migrator/exporting-migration-data-from-github-enterprise-server)"
  - "[AUTOTITLE](/enterprise-server/migrations/using-ghe-migrator/migrating-data-to-github-enterprise-server)"

### Azure DevOps to {% data variables.product.prodname_ghe_server %}

- **Scope**: Source and history
- **Tooling**: Git CLI
- **More information**: "[AUTOTITLE](/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-an-external-git-repository-using-the-command-line)"

### Bitbucket Cloud (Bitbucket.org) to {% data variables.product.prodname_ghe_server %}

- **Scope**: Source and history
- **Tooling**: Git CLI
- **More information**: "[AUTOTITLE](/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-an-external-git-repository-using-the-command-line)"

### Bitbucket Server or Bitbucket Data Center to {% data variables.product.prodname_ghe_server %}

- **Scope**: Source, history, and metadata
- **Tooling**: `bbs-exporter` (expert-led migrations only), then `ghe-migrator`
- **More information**:
  - [{% data variables.product.prodname_expert_services %}](https://github.com/services/) website
  - "[AUTOTITLE](/enterprise-server/migrations/using-ghe-migrator/migrating-data-to-github-enterprise-server)"
- **Caveats**: {% data reusables.migrations.migration-instructions-for-any-git-repository-to-ghes %}

### GitLab to {% data variables.product.prodname_ghe_server %}

- **Scope**: Source, history, and metadata
- **Tooling**: `gl-exporter` (expert-led migrations only), then `ghe-migrator`
- **More information**:
  - [{% data variables.product.prodname_expert_services %}](https://github.com/services/) website
  - "[AUTOTITLE](/enterprise-server/migrations/using-ghe-migrator/migrating-data-to-github-enterprise-server)"
- **Caveats**: {% data reusables.migrations.migration-instructions-for-any-git-repository-to-ghes %}

### Any Git repository to {% data variables.product.prodname_ghe_server %}

- **Scope**: Source and history
- **Tooling**: Git CLI
- **More information**: "[AUTOTITLE](/enterprise-server/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-an-external-git-repository-using-the-command-line)"

### Any Mercurial repository to {% data variables.product.prodname_ghe_server %}

- **Scope**: Source and history
- **Tooling**: Mercurial, Git CLI, and Python
- **More information**: "[AUTOTITLE](/enterprise-server/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-a-mercurial-repository)"

### Any Subversion (SVN) repository to {% data variables.product.prodname_ghe_server %}

- **Scope**: Source and history
- **Tooling**: Subversion and Git CLI
- **More information**: "[AUTOTITLE](/enterprise-server/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-a-subversion-repository)"

### Any Team Foundation Version Control (TFVC) repository to {% data variables.product.prodname_ghe_server %}

- **Scope**: Source and history
- **Tooling**: Azure Repos, then Git CLI
- **More information**: "[AUTOTITLE](/enterprise-server/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-a-team-foundation-version-control-repository)"

### Any Perforce repository to {% data variables.product.prodname_ghe_server %}

- **Scope**: Source and history
- **Tooling**: `git-p4`, then Git CLI
- **More information**:
  - [git-p4](https://git-scm.com/docs/git-p4) in the Git documentation
  - "[AUTOTITLE](/enterprise-server/migrations/importing-source-code/using-the-command-line-to-import-source-code/adding-locally-hosted-code-to-github#importing-a-git-repository-with-the-command-line)"

### Any other repository to {% data variables.product.prodname_ghe_server %}

- **Scope**: Source snapshot
- **Tooling**: {% data variables.product.prodname_cli %} or Git CLI
- **More information**: "[AUTOTITLE](/migrations/importing-source-code/using-the-command-line-to-import-source-code/adding-locally-hosted-code-to-github)"