Skip to main content

Importing a repository with GitHub Importer

If you have a project hosted on another version control system, you can automatically import it to GitHub using the GitHub Importer tool.

About repository imports with GitHub Importer

GitHub Importer is not suitable for all imports. For example, if your existing code is hosted on a private network, our tool won't be able to access it. In these cases, we recommend importing using the command line for Git repositories or an external source code migration tool for projects imported from other version control systems.

Warning: Support for importing Mercurial, Subversion and Team Foundation Version Control (TFVC) repositories using GitHub Importer will end on April 12, 2024. For more information, see the changelog.

If you'd like to match the commits in your repository to the authors' GitHub personal accounts during the import, make sure every contributor to your repository has a GitHub account before you begin the import.

Repositories and individual files are subject to size limits. For more information, see "About large files on GitHub"

For more information about migration paths to GitHub from other products, or between GitHub products, see "Migration paths to GitHub."

Importing a repository with GitHub Importer

When you import a repository using the GitHub Importer, a new repository will be created. If you already have an existing repository you want to use, you can instead add your local repository to GitHub using Git. For more information, see "Adding locally hosted code to GitHub."

  1. In the upper-right corner of any page, click , and then click Import repository.

    Screenshot of the top-right corner of any page on GitHub. A plus icon is highlighted with an orange outline.

  2. Under "Your old repository's clone URL", type the URL of the project you want to import.

  3. Under "Owner", select the dropdown menu and click your personal account or an organization to own the repository

  4. Under "Name", type a name for the repository on GitHub.

  5. Under "Privacy", select a visibility for the repository. For more information, see "Setting repository visibility."

  6. Review the information you entered, then click Begin import.

  7. If your old project requires credentials, type your login information for that project. If SAML SSO or 2FA are enabled for your user account on the old project, enter a personal access token with repository read permissions in the "Password" field instead of your password.

  8. Click Submit.

  9. If there are multiple projects hosted at your old project's clone URL, select the project you'd like to import, then click Submit.

  10. If you're moving from a version control system other than Git and your project contains files larger than 100 MB, select whether to import the large files using Git Large File Storage, then click Continue.

You'll receive an email when the repository has been completely imported.