Article version: Enterprise Server 2.15

This version of GitHub Enterprise will be discontinued on This version of GitHub Enterprise was discontinued on 2019-10-16. 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.

Importing migration data to GitHub Enterprise Server

After generating a migration archive, you can import the data to your target GitHub Enterprise Server instance. You'll be able to review changes for potential conflicts before permanently applying the changes to your target instance.

Preparing the migrated data for import to GitHub Enterprise Server

Before applying the migrated data to your target instance, you'll need to copy the migration archive to your target instance and prepare it for import.

Generating a list of migration conflicts

If ghe-migrator reports conflicts when preparing the data for import, you must generate a list of those conflicts before preparing to resolve them with custom mappings.

Reviewing migration conflicts

After generating a list of migration conflicts, you should review them to ensure that you agree with the default actions ghe-migrator will take when resolving them.

Resolving migration conflicts or setting up custom mappings

Before importing migration data, you can make corrections to resolve conflicts, rename incoming records, or map incoming records to existing records.

Applying the imported data on GitHub Enterprise Server

After you complete your review of the migration data, you can permanently apply the changes to your target instance.

Reviewing migration data

After every step of a migration you can review the state of the migration data. You'll be able to ensure records are being mapped or renamed properly, get the new urls for records after the import step, as well as list out any records that failed to migrate.

Completing the import on GitHub Enterprise Server

After your migration is applied to your target instance and you have reviewed the migration, you'll unlock the repositories and delete them off the source. Before deleting your source data we recommend waiting around two weeks to ensure that everything is functioning as expected.

Ask a human

Can't find what you're looking for?

Contact us