title

shortTitle

intro

versions

Migration paths to GitHub

Migration paths

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.

fpt	ghes	ghec
*	*	*

About migration paths to {% data variables.product.prodname_dotcom %}

{% 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 %} 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 %}
{% data variables.product.prodname_ghe_server %} 3.4.0 or older to {% data variables.product.prodname_dotcom_the_website %}
{% data variables.product.prodname_dotcom_the_website %} to {% data variables.product.prodname_dotcom_the_website %}
Azure DevOps Services (Azure DevOps Cloud) to {% data variables.product.prodname_dotcom_the_website %}
Azure DevOps Server to {% data variables.product.prodname_dotcom_the_website %}
Bitbucket Cloud (Bitbucket.org) to {% data variables.product.prodname_dotcom_the_website %}
Bitbucket Server or Bitbucket Data Center to {% data variables.product.prodname_dotcom_the_website %}
GitLab to {% data variables.product.prodname_dotcom_the_website %}
Any Git repository to {% data variables.product.prodname_dotcom_the_website %}
Any Mercurial repository to {% data variables.product.prodname_dotcom_the_website %}
Any Subversion (SVN) repository to {% data variables.product.prodname_dotcom_the_website %}
Any Team Foundation Version Control (TFVC) repository to {% data variables.product.prodname_dotcom_the_website %}
Any Perforce repository to {% data variables.product.prodname_dotcom_the_website %}
Any other repository to {% data variables.product.prodname_dotcom_the_website %}
{% data variables.enterprise.data_residency_site %} to {% data variables.product.prodname_dotcom_the_website %}

{% 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
- {% data variables.product.prodname_expert_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
- {% data variables.product.prodname_expert_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
- {% data variables.product.prodname_expert_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

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 in the Microsoft Docs
- AUTOTITLE
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 %}.

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

Scope: Source and history
Tooling: Git CLI or {% data variables.product.prodname_importer %}
More information:
- AUTOTITLE
- [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
- {% data variables.product.prodname_expert_services %} website
Caveats:
- {% data reusables.migrations.large-repositories-require-expert-services %}
- {% 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: {% data variables.product.prodname_importer_proper_name %}
More information: {% data variables.product.prodname_expert_services %} website
Caveats:
- If you want to migrate GitLab repositories to GitHub using {% data variables.product.prodname_importer_proper_name %}, please contact our {% data variables.product.prodname_expert_services %} team.
- {% 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 {% data variables.product.prodname_importer %} if the repository is accessible over the public internet
More information:
- AUTOTITLE
- [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

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

Scope: Source and history
Tooling: Subversion and Git CLI
More information: AUTOTITLE

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

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 in the Git documentation
- AUTOTITLE

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

{% data variables.enterprise.data_residency_site %} to {% data variables.product.prodname_dotcom_the_website %}

This path is not currently supported with our official tools. Please contact {% data variables.product.prodname_expert_services %}.

Migrations to {% data variables.enterprise.data_residency_site %}

If you're migrating to {% data variables.enterprise.data_residency %}, your migration destination is {% data variables.enterprise.data_residency_site %}.

Migrations to {% data variables.enterprise.data_residency_site %} use similar tools as migrations to {% data variables.product.prodname_dotcom_the_website %}. However, the {% data variables.product.prodname_importer %} is not available.

Follow a link below to review the scope and tooling for your migration to {% data variables.enterprise.data_residency_site %}, plus any additional information or caveats.

{% data variables.product.prodname_ghe_server %} 3.4.1 or newer to {% data variables.enterprise.data_residency_site %}
{% data variables.product.prodname_ghe_server %} 3.4.0 or older to {% data variables.enterprise.data_residency_site %}
{% data variables.product.prodname_dotcom_the_website %} to {% data variables.enterprise.data_residency_site %}
Azure DevOps Services (Azure DevOps Cloud) to {% data variables.enterprise.data_residency_site %}
Azure DevOps Server to {% data variables.enterprise.data_residency_site %}
Bitbucket Cloud (Bitbucket.org) to {% data variables.enterprise.data_residency_site %}
Bitbucket Server or Bitbucket Data Center to {% data variables.enterprise.data_residency_site %}
GitLab to {% data variables.enterprise.data_residency_site %}
Any Git repository to {% data variables.enterprise.data_residency_site %}
Any Mercurial repository to {% data variables.enterprise.data_residency_site %}
Any Subversion (SVN) repository to {% data variables.enterprise.data_residency_site %}
Any Team Foundation Version Control (TFVC) repository to {% data variables.enterprise.data_residency_site %}
Any Perforce repository to {% data variables.enterprise.data_residency_site %}
Any other repository to {% data variables.enterprise.data_residency_site %}

{% data variables.product.prodname_ghe_server %} 3.4.1 or newer to {% data variables.enterprise.data_residency_site %}

Scope: Source, history, and metadata
Tooling: {% data variables.product.prodname_importer_proper_name %}
More information:
- AUTOTITLE
- {% data variables.product.prodname_expert_services %} website
Caveats:
- {% data reusables.migrations.large-repositories-require-expert-services-ghecom %}
- {% data reusables.migrations.migration-instructions-for-any-git-repository-to-ghecom %}

{% data variables.product.prodname_ghe_server %} 3.4.0 or older to {% data variables.enterprise.data_residency_site %}

Scope: Source, history, and metadata
Tooling: {% data variables.product.prodname_importer_proper_name %}
More information:
- AUTOTITLE
- {% data variables.product.prodname_expert_services %} website
Caveats:
- {% data reusables.migrations.large-repositories-require-expert-services-ghecom %}
- {% data reusables.migrations.migration-instructions-for-any-git-repository-to-ghecom %}

{% data variables.product.prodname_dotcom_the_website %} to {% data variables.enterprise.data_residency_site %}

Scope: Source, history, and metadata
Tooling: {% data variables.product.prodname_importer_proper_name %} or {% data variables.product.prodname_expert_services %}
More information:
- AUTOTITLE
- {% data variables.product.prodname_expert_services %} website
Caveats:
- {% data reusables.migrations.large-repositories-require-expert-services-ghecom %}
- {% data reusables.migrations.migration-instructions-for-any-git-repository-to-ghecom %}

Azure DevOps Services (Azure DevOps Cloud) to {% data variables.enterprise.data_residency_site %}

Scope: Source, history, and metadata
Tooling: {% data variables.product.prodname_importer_proper_name %}
More information: AUTOTITLE

Azure DevOps Server to {% data variables.enterprise.data_residency_site %}

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 in the Microsoft Docs
- AUTOTITLE
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 {% data variables.enterprise.data_residency_site %}.

Bitbucket Cloud (Bitbucket.org) to {% data variables.enterprise.data_residency_site %}

Scope: Source and history
Tooling: Git CLI
More information:
- AUTOTITLE

Bitbucket Server or Bitbucket Data Center to {% data variables.enterprise.data_residency_site %}

Scope: Source, history, and metadata
Tooling: {% data variables.product.prodname_importer_proper_name %}
More information:
- AUTOTITLE
- {% data variables.product.prodname_expert_services %} website
Caveats:
- {% data reusables.migrations.large-repositories-require-expert-services-ghecom %}
- {% data reusables.migrations.migration-instructions-for-any-git-repository-to-ghecom %}

GitLab to {% data variables.enterprise.data_residency_site %}

Scope: Source, history, and metadata
Tooling: Contact {% data variables.product.prodname_expert_services %}
More information: {% data variables.product.prodname_expert_services %} website
Caveats:
- {% data reusables.migrations.migration-instructions-for-any-git-repository-to-ghecom %}

Any Git repository to {% data variables.enterprise.data_residency_site %}

Scope: Source and history
Tooling: Git CLI
More information:
- AUTOTITLE

Any Mercurial repository to {% data variables.enterprise.data_residency_site %}

Scope: Source and history
Tooling: Mercurial, Git CLI, and Python
More information: AUTOTITLE

Any Subversion (SVN) repository to {% data variables.enterprise.data_residency_site %}

Scope: Source and history
Tooling: Subversion and Git CLI
More information: AUTOTITLE

Any Team Foundation Version Control (TFVC) repository to {% data variables.enterprise.data_residency_site %}

Scope: Source and history
Tooling: Azure Repos, then Git CLI
More information: AUTOTITLE

Any Perforce repository to {% data variables.enterprise.data_residency_site %}

Scope: Source and history
Tooling: git-p4, then Git CLI
More information:
- git-p4 in the Git documentation
- AUTOTITLE

Any other repository to {% data variables.enterprise.data_residency_site %}

Scope: Source snapshot
Tooling: {% data variables.product.prodname_cli %} or Git CLI
More information: AUTOTITLE

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 %}
{% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_ghe_server %}
Azure DevOps to {% data variables.product.prodname_ghe_server %}
Bitbucket Cloud (Bitbucket.org) to {% data variables.product.prodname_ghe_server %}
Bitbucket Server or Bitbucket Data Center to {% data variables.product.prodname_ghe_server %}
GitLab to {% data variables.product.prodname_ghe_server %}
Any Git repository to {% data variables.product.prodname_ghe_server %}
Any Mercurial repository to {% data variables.product.prodname_ghe_server %}
Any Subversion (SVN) repository to {% data variables.product.prodname_ghe_server %}
Any Team Foundation Version Control (TFVC) repository to {% data variables.product.prodname_ghe_server %}
Any Perforce repository to {% data variables.product.prodname_ghe_server %}
Any other repository to {% data variables.product.prodname_ghe_server %}
{% data variables.enterprise.data_residency_site %} to {% data variables.product.prodname_ghe_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
- AUTOTITLE

{% 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
- AUTOTITLE

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

Scope: Source and history
Tooling: Git CLI
More information: AUTOTITLE

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

Scope: Source and history
Tooling: Git CLI
More information: AUTOTITLE

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 %} website
- AUTOTITLE
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 %} website
- AUTOTITLE
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

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

Scope: Source and history
Tooling: Mercurial, Git CLI, and Python
More information: AUTOTITLE

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

Scope: Source and history
Tooling: Subversion and Git CLI
More information: AUTOTITLE

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

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

Scope: Source and history
Tooling: git-p4, then Git CLI
More information:
- git-p4 in the Git documentation
- AUTOTITLE

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

{% data variables.enterprise.data_residency_site %} to {% data variables.product.prodname_ghe_server %}

This path is not currently supported with our official tools. Please contact {% data variables.product.prodname_expert_services %}.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!