Migrating repositories between GitHub products

The GitHub CLI simplifies the migration process and is recommended for most customers. Advanced customers with heavy customization needs can use the API to build their own integrations with GitHub Enterprise Importer.

Prerequisites

• To ensure you understand the known support limitations of the Importer, review "About GitHub Enterprise Importer."
• Understand the requirements documented on Managing access for a migration between GitHub products.
• We strongly recommend that you perform a trial run of your migration and complete your production migration soon after. To learn more about trial run best practices, see "Preparing to run a migration with GitHub Enterprise Importer."
• While not required, we recommend halting work during your production migration. The Importer doesn't support delta migrations, so any changes that happen during the migration will not migrate. If you choose not to halt work during your production migration, you'll need to manually migrate these changes.
• You must be either an organization owner or be granted the migrator role for both the source and destination organizations. For more information, see "Granting the migrator role for GitHub Enterprise Importer."

Next steps

• Ensure your runner has been setup (e.g. with necessary tools)
• Self service setup
• Usage guide