Skip to main content

This version of GitHub Enterprise was discontinued on 2023-07-06. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

Migration support for GitHub Enterprise Importer

GitHub Enterprise Importer migrates a variety of data to GitHub from our supported sources.

About migration support for GitHub Enterprise Importer

GitHub Enterprise Importer can migrate to GitHub Enterprise Cloud from any of our supported migration sources. The data included in each migration depends on the source.

GitHub Enterprise Importer supports migrations to GitHub Enterprise Cloud from the following sources.

  • Azure DevOps (ADO) Cloud
  • Bitbucket Server and Bitbucket Data Center 5.14+
  • GitHub.com
  • GitHub Enterprise Server (GHES) 3.4.1+

During the beta, there are known limitations for the Importer that apply to all sources.

Azure DevOps migration support

If your migration source is Azure DevOps, you can migrate repositories.

You can only use GitHub Enterprise Importer to migrate from Azure DevOps Cloud, not from Azure DevOps Server. If you currently use Azure DevOps Server and want to migrate to GitHub, you can migrate to Azure DevOps Cloud first. For more information, see Migrate to Azure DevOps on the Azure site.

We currently only support migrating the following repository data from Azure DevOps to GitHub Enterprise Cloud.

  • Git source (including commit history)
  • Pull requests
  • User history for pull requests
  • Work item links on pull requests
  • Attachments on pull requests
  • Branch protections for the repository (user-scoped branch protections not included)

If you want to migrate Azure Pipelines to GitHub Actions, contact your GitHub account manager.

Bitbucket Server migration support

Note: Migrations from Bitbucket Server using GitHub Enterprise Importer are currently in private beta and subject to change. To request access to the beta, see Join the Bitbucket Server migrations Waitlist.

Migrations from Bitbucket Server are only supported for Bitbucket Server or Bitbucket Data Center version 5.14+ or higher.

If your migration source is Bitbucket Server, you can migrate repositories. We currently only support migrating the following repository data from Bitbucket Server to GitHub Enterprise Cloud.

  • Git source (including commit history)
  • Pull requests (including comments, pull request reviews, pull request review comments at the file and line level, required reviewers, and attachments)

Currently, the following data is not migrated.

  • Branch permissions
  • Commit comments
  • Repository settings

GitHub Enterprise Importer does not migrate CI pipelines from Bitbucket Server.

GitHub.com migration support

If your migration source is GitHub.com, you can migrate individual repositories or entire organizations.

When you migrate an organization, a new organization is created within the destination enterprise account. Then, the following data is migrated to the new organization.

  • Teams
  • Repositories
  • Team access to repositories
  • Member privileges
  • Organization-level webhooks
  • Default branch name for new repositories created in the organization

All repositories are migrated with private visibility. If you want to set a repository's visibility to public or internal, you can do this after the migration using the UI or API.

Team membership is not migrated. After the migration, you'll need to add members to migrated teams. For more information, see "Migrating between GitHub products with GitHub Enterprise Importer."

Note: References to teams, such as @octo-org/octo-team, are not updated as part of an organization migration. This might cause problems in the destination organization, such as CODEOWNERS files not working as expected. For more information about how to prevent and resolve these issues, see "Troubleshooting your migration with GitHub Enterprise Importer."

When you migrate a repository, either directly or as part of an organization migration, only the following data is migrated.

  • Git source (including commit history)
  • Pull requests
  • Issues
  • Milestones
  • Wikis
  • Projects (classic) at the repository level
  • GitHub Actions workflows
  • Commit comments
  • Active webhooks
  • Repository topics
  • Repository settings
    • Branch protections (see "Branch protections" for more details)
    • GitHub Pages settings
    • Autolink references
    • GitHub Advanced Security settings
    • Pull request settings
      • Automatically delete head branches
      • Allow auto-merge
      • Allow merge commits (commit message setting is reset to the default message)
      • Allow squash merging (commit message setting is reset to the default message)
      • Allow rebase merging
  • Releases (up to 10 GB per repository)
  • User history for the above data

Currently, the following data is not migrated.

  • Git LFS objects and large binaries (repositories using Git LFS are still supported, see "Limitations of GitHub Enterprise Importer")
  • GitHub Actions secrets, variables, environments, or workflow run history
  • Webhook secrets
  • GitHub Codespaces secrets
  • Code scanning results
  • Remediation states of secret scanning results
  • Dependabot alerts
  • Dependabot secrets
  • Projects (classic) at the organization level
  • Any Projects (the new projects experience)
  • Discussions at the repository level
  • Packages in GitHub Packages
  • GitHub Apps
  • Fork relationships between repositories (see "About forks")
  • References between pull requests and issues in different repositories (see "Autolinked references and URLs")
  • User access to the repository

When you migrate a repository directly, teams and team access to repositories are not migrated.

Branch protections

Branch protections apply a specified set of rules to a specific branch name or branch name pattern. For more information, see "About protected branches."

Branch protections will always be migrated, but certain rules will not be migrated. The following branch protection rules are not migrated.

  • Allow specific actors to bypass required pull requests
  • Require approval of the most recent push
  • Require deployments to succeed before merging
  • Lock branch
  • Restrict pushes that create matching branches
  • Allow force pushes

The following limitations also apply:

  • If a branch protection rule optionally allows you to specify people, teams, or apps that are exempt from the rule, such as "Restrict who can dismiss pull request reviews," the exceptions will not be migrated.
  • If the "Allow force pushes" rule is enabled in "Specify who can force push" mode, the rule will not be migrated.

GitHub Enterprise Server migration support

If your migration source is GitHub Enterprise Server, you can migrate repositories.

To migrate from GitHub Enterprise Server (GHES), you must have GHES version 3.4.1 or higher.

ItemGHES 3.4.1+GHES 3.5.0+
Git source (including commit history)XX
Pull requestsXX
IssuesXX
MilestonesXX
WikisXX
Projects (classic) at the repository levelXX
GitHub Actions workflowsXX
Commit commentsXX
Active webhooksXX
Branch protectionsXX
GitHub Pages settingsXX
User history for the above dataXX
Releases
X

Different size limits per repository apply depending on your GHES version.

LimitGHES <3.8.0GHES 3.8.0+
Git source2GB10GB
Metadata2GB10GB

Currently, the following data is not migrated.

  • Git LFS objects and large binaries (repositories using Git LFS are still supported, see "Limitations of GitHub Enterprise Importer")
  • GitHub Actions secrets, variables, environments, or workflow run history
  • Webhook secrets
  • GitHub Codespaces secrets
  • Code scanning results
  • Remediation states of secret scanning results
  • Dependabot alerts
  • Dependabot secrets
  • Projects (classic) at the organization level
  • Any Projects (the new projects experience)
  • Discussions at the repository level
  • Packages in GitHub Packages
  • GitHub Apps
  • Fork relationships between repositories (see "About forks")
  • References between pull requests and issues in different repositories (see "Autolinked references and URLs")
  • Teams
  • User or team access to the repository
  • Repository settings for pull requests

Limitations

There are limits to what GitHub Enterprise Importer can migrate. Some are due to limitations of GitHub.com, while others are limitations of GitHub Enterprise Importer itself.

Limitations of GitHub.com

  • 2 GB size limit for a single Git commit: No single commit in your Git repository can be larger than 2 GB. If any of your commits are larger than 2 GB, you will need to split the commit into smaller commits that are each 2 GB or smaller.
  • 255 byte limit for Git references: No single Git reference, commonly known as a "ref", can have a name larger than 255 bytes. Usually, this means that your references cannot be more than 255 characters long, but any non-ASCII characters, such as emojis, may consume more than one byte. If any of your Git references are too large, we'll return a clear error message.
  • 100 MB file size limit: No single file in your Git repository can be larger than 100 MB. Consider using Git LFS for storing large files. For more information, see "Managing large files."

Limitations of GitHub Enterprise Importer

  • 10 GB size limit for a Git repository: This limit only applies to the source code. To inspect the size of your repository, use the git-sizer tool and check the total size of blobs.
  • 10 GB limit for metadata: The Importer cannot migrate repositories with more than 10 GB of metadata. Metadata includes issues, pull requests, releases, and attachments. In most cases, large metadata is caused by binary assets attached to releases. You can exclude releases from the migration with the migrate-repo command's --skip-releases flag, and then move your releases manually after the migration.
  • Git LFS objects not migrated: The Importer can migrate repositories that use Git LFS, but the LFS objects themselves will not be migrated. They can be pushed to your migration destination as a follow-up task after the migration is complete. For more information, see "Duplicating a repository."
  • Follow-up tasks required: When migrating between GitHub products, certain settings are not migrated and must be reconfigured in the new repository. For a list of follow-up tasks you'll need to complete after each migration, see "Migrating between GitHub products with GitHub Enterprise Importer."
  • Delayed code search functionality: Re-indexing the search index can take a few hours after a repository is migrated, and code searches may return unexpected results until re-indexing is complete.