TL;DR 🚀

These are the only commands you need to sync your forked repo with the original repo

1
2
3
4
5

git remote add upstream https://github.com/<Original Owner Username>/<Original Repository>.git
git fetch upstream
git checkout master
git merge upstream/master
git push

Why should I do this? 😏

Before submitting any pull request, syncing your forked repository with original repository is an important step to perform, as you may want to get the bug fixes or additional features to merge with your code since the time you forked the original repo.

But I can do a PR instead.. 💁‍♀️

You can, but that adds an extra commit into your forked repo instead of matching it with the original repo.

Inorder to sync without any additional changes as a part of the process,

• Configure the original repo as upstream remote.
• Merge changes from original repo
• Push the merged version back to Github.

Adding original repo as an upstream

• Open the forked repo in your Git Bash or command prompt or terminal.
• List the current configured remote repositories

1
2
3

git remote -v
> origin  https://github.com/<YOUR_USERNAME>/<YOUR_FORK>.git (fetch)
> origin  https://github.com/<YOUR_USERNAME>/<YOUR_FORK>.git (push)

• Add the original repo as upstream repo

1

git remote add upstream https://github.com/<ORIGINAL_OWNER>/<ORIGINAL_REPOSITORY>.git

• Verify the new upstream repo for your forked repo

1
2
3
4
5

git remote -v
> origin    https://github.com/<YOUR_USERNAME>/<YOUR_FORK>.git (fetch)
> origin    https://github.com/<YOUR_USERNAME>/<YOUR_FORK>.git (push)
> upstream  https://github.com/<ORIGINAL_OWNER>/<ORIGINAL_REPOSITORY>.git (fetch)
> upstream  https://github.com/<ORIGINAL_OWNER>/<ORIGINAL_REPOSITORY>.git (push)

You can now pull the changes from original repo.

Merge changes from upstream

• Open the forked repo in your Git Bash or command prompt or terminal.
• First things first, fetch the changes (branches and their commits) from upstream

1
2
3
4
5
6
7

git fetch upstream
> remote: Counting objects: 75, done.
> remote: Compressing objects: 100% (53/53), done.
> remote: Total 62 (delta 27), reused 44 (delta 9)
> Unpacking objects: 100% (62/62), done.
> From https://github.com/<ORIGINAL_OWNER>/<ORIGINAL_REPOSITORY>
>  * [new branch]      master     -> upstream/master

Note : Commits to the original repo(master) will be stored in a local branch, upstream/master

• Make sure you are on your local (fork’s) master branch

1
2

git checkout master
> Switched to branch 'master'

• The last step, which achieves our goal: Merge changes from original repo (upstream/master) into your forked repo(master).

1
2
3
4

git merge upstream/master
> Updating a422352..5fdff0f
> Fast-forward
>  ...

This step brings changes of forked repo in sync with original repo, without losing any uncommited changes :D

Optional Step

If you made changes to your repo and want to push them back to Github

1

git push origin master

Until next time 👋, Happy learning! 🎉 💻

If you found this helpful, please give a shoutout to @gsavitha_ and share this article to help others. For more articles like this, subscribe to my Newsletter and get the latest updates straight to your inbox.