Migration paths to GitHub

See an overview of the paths available for migration to GitHub from other products, or between GitHub products.

In this article

About migration paths to GitHub

If you're moving between GitHub products, such as from GitHub Enterprise Server to GitHub Enterprise Cloud, or from another code hosting platform, such as Bitbucket Server or GitLab, to GitHub, 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 GitHub's Sales team or see the GitHub 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 GitHub.com

You can review the scope and tooling for your migration to GitHub.com, which includes migrations to GitHub Enterprise Cloud. You can also review any additional information or caveats.

GitHub Enterprise Server 3.4.1 or newer to GitHub.com

  • Scope: Source, history, and metadata
  • Tooling: GitHub Enterprise Importer
  • More information:
  • Caveats:
    • For complex repositories larger than around 5 GB, you may need to use ghe-migrator and Enterprise Cloud Importer instead. Enterprise Cloud Importer is only available for expert-led migrations.
    • 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 GitHub.com."

GitHub Enterprise Server 3.4.0 or older to GitHub.com

  • Scope: Source, history, and metadata
  • Tooling: GitHub Enterprise Importer
  • More information:
  • Caveats:
    • For complex repositories larger than around 5 GB, you may need to use ghe-migrator and Enterprise Cloud Importer instead. Enterprise Cloud Importer is only available for expert-led migrations.
    • 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 GitHub.com."

GitHub.com to GitHub.com

Migrations from GitHub.com include GitHub Enterprise Cloud. This path includes adoption of Enterprise Managed Users or a move between managed enterprises.

  • Scope: Source, history, and metadata
  • Tooling: GitHub Enterprise Importer or GitHub Expert Services
  • More information:
  • Caveats:
    • For complex repositories larger than around 5 GB, you may need to use ghe-migrator and Enterprise Cloud Importer instead. Enterprise Cloud Importer is only available for expert-led migrations.
    • 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 GitHub.com."

Azure DevOps Services (Azure DevOps Cloud) to GitHub.com

Azure DevOps Server to GitHub.com

Bitbucket Cloud (Bitbucket.org) to GitHub.com

Bitbucket Server or Bitbucket Data Center to GitHub.com

  • Scope: Source, history, and metadata
  • Tooling: GitHub Enterprise Importer
  • More information:
  • 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.
    • 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 GitHub.com."

GitLab to GitHub.com

  • Scope: Source, history, and metadata
  • Tooling: gl-exporter, then Enterprise Cloud Importer (expert-led migrations only)
  • More information: GitHub Expert Services website
  • Caveats:
    • Enterprise Cloud Importer is only available for expert-led migrations.
    • 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 GitHub.com."

Any Git repository to GitHub.com

Any Mercurial repository to GitHub.com

Any Subversion (SVN) repository to GitHub.com

Any Team Foundation Version Control (TFVC) repository to GitHub.com

Any Perforce repository to GitHub.com

Any other repository to GitHub.com

GHE.com to GitHub.com

This path is not currently supported with our official tools. Please contact GitHub Expert Services.

Migrations to GHE.com

If you're migrating to GitHub Enterprise Cloud with data residency, your migration destination is GHE.com.

Migrations to GHE.com use similar tools as migrations to GitHub.com. However, the GitHub Importer and Enterprise Cloud Importer are not available.

Follow a link below to review the scope and tooling for your migration to GHE.com, plus any additional information or caveats.

GitHub Enterprise Server 3.4.1 or newer to GHE.com

GitHub Enterprise Server 3.4.0 or older to GHE.com

GitHub.com to GHE.com

  • Scope: Source, history, and metadata
  • Tooling: GitHub Enterprise Importer or GitHub Expert Services
  • More information:
  • Caveats:
    • For complex repositories larger than around 5 GB, we recommend contacting GitHub 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."

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

  • Scope: Source, history, and metadata
  • Tooling: Contact GitHub Expert Services
  • More information: GitHub Expert Services website
  • Caveats:

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

Migrations to GitHub Enterprise Server

You can review the scope and tooling for your migration to GitHub Enterprise Server, including any additional information or caveats.

GitHub.com to GitHub Enterprise Server

Migrations from GitHub.com include GitHub Enterprise Cloud.

GitHub Enterprise Server to GitHub Enterprise Server

Azure DevOps to GitHub Enterprise Server

Bitbucket Cloud (Bitbucket.org) to GitHub Enterprise Server

Bitbucket Server or Bitbucket Data Center to GitHub Enterprise Server

GitLab to GitHub Enterprise Server

Any Git repository to GitHub Enterprise Server

Any Mercurial repository to GitHub Enterprise Server

Any Subversion (SVN) repository to GitHub Enterprise Server

Any Team Foundation Version Control (TFVC) repository to GitHub Enterprise Server

Any Perforce repository to GitHub Enterprise Server

Any other repository to GitHub Enterprise Server

GHE.com to GitHub Enterprise Server

This path is not currently supported with our official tools. Please contact GitHub Expert Services.