331

Can one transfer repositories from GitLab to GitHub if the need be. If so, how exactly can I go about doing the same?

Also, are there any pitfalls in doing so or precautionary measures that I need to keep in mind before doing so given that I may decide to eventually move them to GitHub (as it has more features at the moment that I might find handy for my project).

Andrew Walker
  • 40,984
  • 8
  • 62
  • 84
boddhisattva
  • 6,908
  • 11
  • 48
  • 72
  • 1
    Readers: there are two types of answers below - those that import just the Git repository itself (with history), and those that also attempt to import other things like Merge/Pull Requests, Issues, etc. The methods that import just the repository files & history are all doing the same thing under the hood, just using different procedures. Methods doing the latter (currently just one answer by @1u-) will give you a more complete import. – Ken Williams Feb 28 '23 at 20:08

11 Answers11

359

You can transfer those (simply by adding a remote to a GitHub repo and pushing them)

  • create an empty repo on GitHub
  • git remote add github https://yourLogin@github.com/yourLogin/yourRepoName.git
  • git push --mirror github

The history will be the same.

But you will lose the access control (teams defined in GitLab with specific access rights on your repo)

If you face any issue with the https URL of the GitHub repo:

The requested URL returned an error: 403

All you need to do is to enter your GitHub password, but the OP suggests:

Then you might need to push it the ssh way. You can read more on how to do it here.

See "Pushing to Git returning Error Code 403 fatal: HTTP request failed".

Note that mike also adds in the comments:

GitLab can also be set to push mirror to downstream repositories, and there are specific instructions for push mirroring to GitHub.
This can use a GitHub Personal Access Token and also be set to periodically push.
You might use this option to share on GitHub, but keep your main development activity in your GitLab instance.

tswaehn suggests in the comments the tool piceaTech/node-gitlab-2-github

It is possible to migrate issues, labels, ... with this tool github.com/piceaTech/node-gitlab-2-github: I tested it, not bad.
But had issues when transferring attachments of the issues itself.
Still worth a try maybe.

VonC
  • 1,262,500
  • 529
  • 4,410
  • 5,250
  • Thanks Von - your answer did the trick for me.I've just added a bit to your answer regarding the exact git remote add cmd and pushing things the ssh way if the need be. Hope that's okay. – boddhisattva Mar 08 '14 at 09:29
  • @boddhisattva It is ok, but I see your edit was rejected. I have added it back in the answer myself. – VonC Mar 08 '14 at 10:05
  • 9
    Any comments on importing issues and labels? Can anything other than code be imported by pull and push? Thanks. –  May 31 '15 at 19:18
  • @YakovK I am not aware of an automatic process taking into account PR and issues. At least, PR in GitHub are branches (see http://stackoverflow.com/a/30542987/6309), so that could be imported. – VonC May 31 '15 at 20:25
  • @VonC where would you need to enter your GitHub password after the 403 error? I'm trying to migrate from gitlab to github and I'm finding it to be a pain – Santiago Suárez Feb 04 '16 at 20:14
  • @VonC I already answered my own question, upgraded my git version and it automatically prompted for my credentials when following your answer, Thanks! – Santiago Suárez Feb 04 '16 at 20:31
  • @SantiagoSuárez Great! Sorry for the late answer. I wasn't available. – VonC Feb 04 '16 at 21:21
  • This works well, however it only pushed tags and the master. Any idea how I can get the branches, too? – kiki Feb 06 '17 at 13:03
  • 3
    @kiki it will push *all* local branches, but if your local repo is itself a clone, it will have only master as its default local checked out branch. You must first create the other local branches after their repsective remote tracking branches, before using `push --mirror`. http://stackoverflow.com/a/18911322/6309. See also the alternative mentioned at http://stackoverflow.com/a/24099141/6309 (last sentence) – VonC Feb 06 '17 at 14:25
  • git: 'credential-manager' is not a git command. See 'git --help'. !? – jtlz2 Apr 10 '19 at 05:56
  • @jtlz2 Check your `%PATH%`. Mine includes `c:\path\to Git\bin;c:\path\to Git\cmd;c:\path\to Git\usr\bin;c:\path\to Git\mingw64\bin`. With that, credential-manager is correctly interpreted. – VonC Apr 10 '19 at 06:11
  • Does this create a new repo on github or would you have to do that via web browser first? – Akron Nov 22 '19 at 18:44
  • @Akron You have to create a new empty GitHub repository on the web first, then you can add locally the remote URL of the GitHub repository you just created, and push to it. – VonC Nov 22 '19 at 22:14
  • Does this mean that when I want to push new changes I would have to do git push github [branch_name] instead of using origin? – Reggie Escobar Dec 24 '21 at 06:25
  • 3
    @ReggieEscobar No, you can delete `origin,` (`git remote remove origin`) rename `github` `origin` as `origin` (`git remote rename origin github`), and go on `git push` (to `origin`, which is now GitHub): the transfer from GitLab to GitHub is complete. – VonC Dec 24 '21 at 12:52
  • GitLab can also be set to [push mirror](https://docs.gitlab.com/ee/user/project/repository/mirror/push.html) to downstream repositories, and there are [specific instructions for push miroring to GitHub](https://docs.gitlab.com/ee/user/project/repository/mirror/push.html#set-up-a-push-mirror-from-gitlab-to-github). This can use a GitHub Personal Access Token and also be set to periodically push. You might use this option to share on GitHub, but keep your main development activity in your GitLab instance – mike May 12 '22 at 20:26
  • 1
    @mike Good point, thank you. I have included your comment in the answer for more visibility. – VonC May 12 '22 at 22:15
  • Thank you but this is not importing a project. It's how to import a repository. – Fellipe Tavares Jan 18 '23 at 15:50
  • 1
    @FellipeTavares I agree: importing a project (repo+MR+issues+wiki+...) is trickier, as [described here](https://dev.to/oneadvanced/migrating-from-gitlab-to-github-4men#a-note-on-merge-requests). – VonC Jan 18 '23 at 17:51
  • just adding for reference, additionally it is possible to migrate issues, labels, ... with this tool https://github.com/piceaTech/node-gitlab-2-github I tested it, not bad. but had issues when transfering attachements of the issues itself. still worth a try maybe. – tswaehn Mar 10 '23 at 13:44
290

This is very easy by import repository feature:

Login to github.com,

Side of profile picture you will find + button click on that then there will be option to import repository:

enter image description here

You will find a page like this:

enter image description here

Your old repository’s clone URL is required which is gitlab repo url in your case.

Then select Owner and then type name for this repo and click to begin import button.

mit
  • 11,083
  • 11
  • 50
  • 74
manoj
  • 5,235
  • 7
  • 24
  • 45
  • 56
    That is super convenient that GitHub has added that. However, it won't work if it is an internal GitLab behind a firewall, which represents a large use case for GitLab. – abalter Jun 29 '17 at 05:03
  • 26
    Just a quick note for anyone else using the import option. I had to disable MFA on GitLab for this to work. – D-Day Mar 11 '18 at 19:09
  • 3
    This works fine. Much better than the accepted answer – LnxSlck Jun 20 '19 at 10:28
  • How if i want to import branch ? – questionasker Jun 26 '19 at 13:44
  • 2
    The imported repository does not necessarily have to be public now, as github has made adding private repositories free. – Shrey Garg Oct 29 '19 at 08:03
  • 1
    In case that Gitlab repository is private, I had to create previously a token in Gitlab with read only access, then I can use these credentials to login in Github when the import step ask me – Hector Aug 31 '20 at 15:47
  • 15
    @D-Day you do not need to disable MFA. I faced the same problem, all you need to do is create a personal access token on GitLab and use that as your password while importing to GitHub. – Sajib Acharya Oct 20 '20 at 09:01
  • 2
    this only transfers the repo itself, no issues, PRs, labels, milestones or anything else. Still easier than doing it from gitlab to local to github – gaurav5430 Jun 01 '21 at 17:34
  • 1
    No issues or tags transfered .. IMO insuficcient, I would have expected more – Alex Sep 15 '21 at 09:31
  • much better! but will this transfer the repos history of commits too? – Nemra Khalil Dec 01 '21 at 20:12
  • @NemraKhalil yes it transfers the git history/branches/etc, but not the additional gitlab content (permissions, issues, tags, etc) – Michael Delgado Dec 15 '21 at 22:40
  • I tried this method to import from bitbucket but it did not find my repo even with the correct credentials. I tried both email and username in separate attempts – MehranTM Feb 10 '22 at 22:02
  • To complete the action you might want to make sure your local repository points to the new remote by running the following command `git remote set-url origin https://github.com/your-repository.git` – nsof Mar 02 '22 at 09:48
28

If you want to migrate the repo including the wiki and all issues and milestones, you can use node-gitlab-2-github or GitLab to GitHub migration

Daira Hopwood
  • 2,264
  • 22
  • 14
1u-
  • 565
  • 5
  • 10
  • 2
    FYI node-gitlab-2-github can migrate issues, PRs, labels and milestones and is a little more feature rich, the other one can migrate issues, milestones and wikis , but is a little less sophisticated – gaurav5430 Jun 01 '21 at 17:32
  • Can it be used for a bulk import? (ie, without creating manually repos on gh?) – Alsushi Sep 14 '22 at 15:38
8

For anyone still looking for a simpler method to transfer repos from Gitlab to Github while preserving all history.

Step 1. Login to Github, create a private repo with the exact same name as the repo you would like to transfer.

Step 2. Under "push an existing repository from the command" copy the link of the new repo, it will look something like this:

git@github.com:your-name/name-of-repo.git

Step 3. Open up your local project and look for the folder .git typically this will be a hidden folder. Inside the .git folder open up config.

The config file will contain something like:

[remote "origin"]
url = git@github.com:your-name/name-of-repo.git
fetch = +refs/heads/:refs/remotes/origin/

Under [remote "origin"], change the URL to the one that you copied on Github.

Step 4. Open your project folder in the terminal and run: git push --all. This will push your code to Github as well as all the commit history.

Step 5. To make sure everything is working as expected, make changes, commit, push and new commits should appear on the newly created Github repo.

Step 6. As a last step, you can now archive your Gitlab repo or set it to read only.

Dan Lowe
  • 51,713
  • 20
  • 123
  • 112
Leon Matota
  • 332
  • 5
  • 8
  • for further reading, look at this article https://android.jlelse.eu/how-to-migrate-gitlab-bitbucket-to-github-in-a-simple-way-e38bc60b1547 – Leon Matota Nov 19 '20 at 13:09
  • if this method does not have "pitfalls", it is a nice way to push to gitlab and github at the same time. You should just type relevant urls: one under another. – uch Aug 16 '21 at 13:14
6

You can use the following commands:

cd existing_repository
git remote rename origin old-origin
git remote add origin <yourRepository.git>
git push -u origin --all
git push -u origin --tags

If an error occurs, you can try to force the push using the -f command, type like this:

git push -u -f origin --all
git push -u -f origin --tags

This would be the path recommended by GitLab to import an existing repository on GitHub, however, if you change the <yourRepository.git> link to the repository link on GitHub it is possible to go the other way, transferring from GitLab to GitHub. In practice, you create a new origin and force a push of everything.

Maykon Meneghel
  • 335
  • 6
  • 8
4

One simple solution can be to add one more remote URL to your local repository.

Steps:

git remote add <name> <URL>
git push name

Example:

git remote add github_origin https://github.com/...
git push github_origin
Rajeet Goyal
  • 69
  • 4
3

If you have MFA enabled on GitLab you should go to Repository Settings/Repository ->Deploy Keys and create one, then use it as login while importing repo on GitHub

Alex Mokrushin
  • 31
  • 2
  • 2
    Almost certainly you want a deploy _token_, not a deploy key. (You need a username/password to give to GitHub, and you can't upload private ssh keys there.) – Michael M. Jul 23 '21 at 17:30
2

With default Github repository import it is possible, but just make sure the two factor authentication is not enabled in Gitlab.

Thanks

Shuvankar Paul
  • 1,124
  • 10
  • 11
2

You can simply transfer your GitLab project to GitHub with included histories and commits following these 2 steps:

  1. Click setting on the right-hand side of your Github profile and select import repository. Then on the old repository URL paste the Gitlab repository link you want to transfer. Follow the attached screenshot Steps to import git repository

  2. Click on import then wait a minutes after verifying login credentials, Finally you're done. Check your GitHub Repository to see the changes.

Gopal Bogati
  • 23
  • 3
0

You can import repositories from gitlab into github use user interface (UI) with following instructions:

-> Firstly login in gitlab

-> Then copy the link of a project in gitlab

-> Then Goto github and sign in

-> Press (+) from right side of the github interface

-> Then click on the import repository

-> Then Paste the link in "Your old repository’s clone URL" in field

-> Then right the reporitory name

-> Then select private/public

-> Then press "Begin Import" button

It will import all the files with commit of your gitlab project.

After completing the project it will show

" Importing complete! Your new repository "link" is ready.

Finally your project is imported.

Md. Samim hossain
  • 247
  • 3
  • 7
0

Be sure that you do not have MFA enabled on your GitLab's user account, otherwise it won't work. If you have MFA enabled (as it should be), disable it temporarly until you perform the import, and re-enable it again.

oxyrend
  • 119
  • 5