Skip to main content

Migrated data for live migrations from GitHub Enterprise Server to GHE.com

Which data and live updates are included in a live migration?

Data that is migrated

ELM migrates almost all repository-level data. Organization-level resources, such as teams, projects, and organizations settings and webhooks, are excluded from the migration and must be configured manually on the target.

The only organization-level action supported by ELM is the creation of a target organization account if this does not already exist.

Repository settings and configuration

ResourceNotes
Repository metadata and settingsVisibility, description, default branch, and enabled features
Repository webhooksWebhook configurations for the repository
Repository topicsTags for categorizing the repository
Repository PR settingsPull request merge and review settings
Actions settingsRepository-level GitHub Actions configuration, including allowed actions and permissions
AutolinksCustom autolink references
Branch protectionsBranch protection rules are partially migrated, with the limitations described below
PagesGitHub Pages configuration

Warning

Branch protection migration is partially supported. ELM preserves whether actor restrictions are enabled for dismissing pull request reviews and pushing to protected branches, but it does not preserve the permitted users, teams, or apps. A push restriction can therefore be recreated on the destination with an empty allowlist. It also does not migrate pull request bypass actors, force-push actors, status check app bindings, matching-branch creation restrictions, merge queue settings, deployment requirements, or branch locking. Review and update migrated branch protection rules before allowing users to work in the destination repository.

Git data, LFS, and wikis

ResourceNotes
Git repository (refs, objects, history)Includes all refs, objects, and commit history. The repository is kept up to date on the destination throughout the migration.
LFS objectsGit Large File Storage objects. Requires LFS to be enabled on the source GitHub Enterprise Server instance.
WikiThe wiki Git repository

Issues, comments, and reactions

ResourceNotes
IssuesIncludes state, assignees, and body
Issue commentsAll comments on issues
Issue reactionsReactions on issues
Issue comment reactionsReactions on issue comments
Issue labelsLabel associations on issues
Issue eventsTimeline events (assigned, labeled, closed, etc.)
Close issue referencesCross-references that close issues (e.g. "fixes #123")

Pull requests, reviews, and threads

ResourceNotes
Pull requestsIncludes state, reviewers, body, and draft status
PR reviewsSubmitted reviews, including approved, changes-requested, and commented states
PR review commentsInline code review comments
PR review threadsThreaded discussions, including resolved and unresolved state
PR comment reactionsReactions on pull request review comments
PR labelsLabel associations on pull requests

Labels, milestones, releases, and CI

ResourceNotes
LabelsLabel definitions, including name, color, and description
MilestonesMilestone definitions and state
ReleasesRelease metadata, including tag, name, body, and prerelease or draft status
Release reactionsReactions on releases
Commit commentsComments on individual commits
Commit status checksCI/CD status checks on commits
Check runsCheck run results
Check suitesCheck suite groupings
Team repository permissionsTeam-to-repository permission associations

Binary assets and file attachments

ResourceNotes
Release assetsBinary assets attached to releases, up to 2 GB per asset
AttachmentsImage and video file attachments embedded in issue and pull request bodies
Repository files (non-media attachments)Non-media file attachments, such as PDFs and text files, associated with issues and pull requests

Users and mannequins

ResourceNotes
MannequinsEvery GitHub Enterprise Server user referenced in migrated data is represented as a mannequin: a placeholder identity with no organization membership or repository access. After your migration is complete, you can reclaim mannequins by associating them with real user accounts.

Data that is not migrated

Repository data

DataNotes
Repository defaultsN/A
Repository rulesetsRepository rulesets are not migrated. Branch protection rules are partially migrated.
Pull requests from forksN/A
Pending pull request reviewsOnly submitted reviews are migrated.

Organization data

Organization-level data such as the following is not migrated:

  • Settings
  • Teams
  • Projects
  • Webhooks

Events included in live updates

After the initial backfill completes, the exporter's event listener monitors webhooks on GitHub Enterprise Server to capture ongoing changes and forward them to the migration service on the target enterprise.

The following tables document which resource types support live updates and which webhook actions are handled.

Resource typeSupported eventsUnsupported events
Repositoryeditedarchived, deleted, privatized, publicized, renamed, transferred, unarchived
Issuesassigned, closed, edited, labeled, opened, reopened, unassigned, unlabeled, milestoned, demilestoneddeleted, locked, pinned, transferred, unlocked, unpinned
Issue commentcreated, editeddeleted
Pull requestassigned, closed, converted_to_draft, edited, labeled, opened, ready_for_review, reopened, unassigned, unlabeled, milestoned, demilestonedauto_merge_disabled, auto_merge_enabled, dequeued, enqueued, locked, review_request_removed, review_requested, synchronize, unlocked
Pull request reviewedited, submitteddismissed
Pull request review commentedited