Move Local Git Repository to Bitbucket

published by on

As I described in previous post, when I joined to my current company, we hadn't any versioning system, not even SVN and we used to FTP all files to XY number of backup folders. I introduced Git on local servers. Everything started to seem better, but after some time we started to work with some people from abroad and one of colleagues started to work from home. That meant that they couldn't connect to local network to push to GIT. Setting up VPS wasn't option, as our boss was worried lot about the security and didn't want to people connect to office network from home, etc. Private repositories on github are paid for and codebases of our clients couldn't be shared world wide. I remembered, that in one of my previous jobs we used bitbucket, which was free to team of 5 developers and offer unlimited number of repositories. It seemed that boss will happily pay nothing for free tool and manager will accept that repositories are private with access management.

What we want to achieve?

We already had our codebase under git repository. I didn't want to loose the history of commits. We also had some branches, with some dev work on it. Those branches wasn't aprroved and safe to merge into master branch. I wanted to have all this stuff also on bitbucket. You will see that this process is really easy. Our current repository is tracking the existing remote repository on our local server. So first, we will remove the tracking of remote repository on local working directory, then we will create new repository in bitbucket and finally we will attach our repository to bitbucket remote and push all changes to repository.

What we need?

  • bitbucket account (free)
  • unix terminal
  • local working directory of GIT repository.

1. Detach the remote from your local repo

First let's go to the projects folder

    Stefans-iMac:~ stefan$ cd Projects/ stefan$ 

Git has command to manage set of tracked ("remotes") repositories. It's called git-remote. stefan$ git remote

As you can see our working directory is tracking origin repository. Using the verbose parameter -v we can even check it's remote url after name stefan$ git remote -v
    origin  user@ (fetch)
    origin  user@ (push)

Working directory can track even more than one remote and you can usually pull or push to any of them, but that depends on permissions. Now we are going to remove the only remote, the origin. stefan$ git remote rm origin

2 .Create new Bitbucket repository

We need to login to our bitbucket account and select to create new repository form the top menu, then fill the simple form and voila. We have new repository.

Creating new Bitbucket Repository

In next step we will need to have the link to repository and for that we will need https url. You can find it in repository Overview page and make a copy into your clipboard.

Bitbucket Repository url

Mine GIT https URL looks like this:

3. Attach your code to new remote repo and push your project

Now lets get back into terminal into our project folder. We will use the URL of our remote repo to attach it to our project. stefan$ git remote add origin

We can check now if the remote repo is correctly attached. stefan$ git remote -v
    origin (fetch)
    origin (push)

Yes, we can see it is attached. So we can push our project to remote repository. Probably you will need to enter your password for bitbucket. You may also wait a few moments while project is uploaded. stefan$ git push -u origin --all
    Password for '': 
    Counting objects: 18702, done.
    Delta compression using up to 4 threads.
    Compressing objects: 100% (18666/18666), done.
    Writing objects: 100% (18702/18702), 73.54 MiB | 636.00 KiB/s, done.
    Total 18702 (delta 16400), reused 0 (delta 0)
     * [new branch]      booking-system -> booking-system
     * [new branch]      develop -> develop
     * [new branch]      master -> master
    Branch booking-system set up to track remote branch booking-system from origin.
    Branch develop set up to track remote branch develop from origin.
    Branch master set up to track remote branch master from origin.

The project code is now successfully pushed to remote repository. It also created all branches I had locally in remote repository. We can now log into bitbucket and see all our code there, altogether with commits history. There is one more step you might like to do, just in case you have used tagging (v.1.0.0 etc.). The tags are being added to repository separately, by using command git push -u origin --tags , which pushes all tags from your local repository to the new bitbucket repository.

History of repository commits


I showed you how easy is to create new repository in bitbucket. We have learned how to chcek what remote repos is tracking your project, we detached remote bare GIT repository from the working directory of project and we learned how to attach another remote repo to local project. In steps above I used the bitbucket, but the process would be very same for any other remote repo (github, your subdomain, etc...). I also hope that there are no other obstacles preventing my dev team members from using git and revert to ftp backups.

Tags: git bitbucket