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.

Tip: 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.

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 "What is my disk quota?"

  1. In the upper-right corner of any page, click , and then click Import repository. Import repository option in new repository menu
  2. Under "Your old repository's clone URL", type the URL of the project you want to import. Text field for URL of imported repository
  3. Choose your personal account or an organization to own the repository, then type a name for the repository on GitHub. Repository owner menu and repository name field
  4. Specify whether the new repository should be public or private. For more information, see "Setting repository visibility." Public or private repository radio buttons
  5. Review the information you entered, then click Begin import. Begin import button
  6. If your old project requires credentials, type your login information for that project, then click Submit. 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. Password form and Submit button for password-protected project
  7. If there are multiple projects hosted at your old project's clone URL, choose the project you'd like to import, then click Submit. List of projects to import and Submit button
  8. If your project contains files larger than 100 MB, choose whether to import the large files using Git Large File Storage, then click Continue. Git Large File Storage menu and Continue button

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

Further reading