A tool for bulk migration of Bitbucket private repos to Github

Please make sure you read the safety information before proceeding: there's an edge case that could expose your private repos.

Before starting make sure you can clone your Bitbucket repos by running on one of them

> git clone git@bitbucket.org:${USERNAME}/${REPONAME}.git

If this doesn't work please fix it before continuing.

Configuration

Copy env to .env
Go to https://bitbucket.org/account/user/{USERNAME}/app-passwords and create an app password with read on repositories as the only permission
Fill your .env file with the relevant bitbucket data
Go to https://github.com/settings/tokens/new and generate a new token with all the repo permissions.
Fill your .env file with the relevant github data

Launch

You'll need node and yarn installed

> yarn && yarn start

Extra

Advanced Configuration

If you wanted to change the email you used in bitbucket during the migration (or the name of your user) you could also fill the OLD_EMAIL, CORRECT_NAME, CORRECT_EMAIL in the .env file. More information about this option

Safety Information

The Github repos are always created as private.
If a Github repo with the same name exists and has existing commits is left untouched.
If a Github repo with the same name and no previous history exists, the Bitbucket content gets pushed WITHOUT checking wether is private or not.
The Bitbucket repos don't get deleted.

Todo

I haven't tried it with a repo having multiple branches.

cedmax / bitbucket-to-github