I forked a project, made changes, and created a pull request which was accepted. New commits were later added to the repository. How do I get those commits into my fork?
-
158This can also be done from the github UI. I'd like to give credit [to this other poster][1]. [1]: stackoverflow.com/a/21131381/728141– Mike SchrollCommented Feb 20, 2014 at 13:00
-
5Another good blog post on this - Keeping A GitHub Fork Updated– Arup RakshitCommented Oct 15, 2014 at 17:26
-
4Found this in Github help articles: help.github.com/articles/syncing-a-fork– PranavCommented Apr 2, 2015 at 8:57
-
2Is this a duplicate of stackoverflow.com/questions/3903817/… ?– David CaryCommented Aug 29, 2015 at 12:06
-
4Since May 2021 this is directly possible from the GitHub UI without extra pull request, see changelog and stackoverflow.com/a/67425996– Marcono1234Commented May 8, 2021 at 0:23
32 Answers
In your local clone of your forked repository, you can add the original GitHub repository as a "remote". ("Remotes" are like nicknames for the URLs of repositories - origin
is one, for example.) Then you can fetch all the branches from that upstream repository, and rebase your work to continue working on the upstream version. In terms of commands that might look like:
# Add the remote, call it "upstream":
git remote add upstream https://github.com/whoever/whatever.git
# Fetch all the branches of that remote into remote-tracking branches
git fetch upstream
# Make sure that you're on your main branch:
git checkout main
# Rewrite your main branch so that any commits of yours that
# aren't already in upstream/main are replayed on top of that
# other branch:
git rebase upstream/main
If you don't want to rewrite the history of your main branch, (for example because other people may have cloned it) then you should replace the last command with git merge upstream/main
. However, for making further pull requests that are as clean as possible, it's probably better to rebase.
If you've rebased your branch onto upstream/main
you may need to force the push in order to push it to your own forked repository on GitHub. You'd do that with:
git push -f origin main
You only need to use the -f
the first time after you've rebased.
-
122As your fork only exists on github, and github does not have tools for doing merges through the web interface, then the right answer is to do the upstream merge locally and push the changes back to your fork. Commented Jun 19, 2012 at 3:50
-
66A quick note that rather than having to rebase your own master branch to ensure you are starting with clean state, you should probably work on a separate branch and make a pull request from that. This keeps your master clean for any future merges and it stops you from having to rewrite history with
-f
which messes up everyone that could have cloned your version. Commented May 29, 2013 at 23:09 -
15Instead of the rebase command, i used the following:
git merge --no-ff upstream/master
This way your commits aren't on top anymore. Commented Oct 17, 2016 at 13:20 -
30@jww: You ask why Git needs to be told about the original GitHub repository. It is because Git is a decentralized version control system and is not tied to GitHub in any way; it is probably obvious that Git was created before GitHub. When you create a forked repository on GitHub and clone it, GitHub knows that the repository is a fork; Git has no reason to, and does not. (Why doesn't the clone copy the Git remotes? Git is decentralized; different people will want different remotes; it would make no sense to do this.) See github.com/github/hub for GitHub integration in Git. Commented Jun 4, 2017 at 4:43
-
9@Sinjai There is explicit support for these webservices. It's called the remote system. You specify the URL, and then push/pull. Speaking quite literally, I don't think it could possibly get any simpler without hardcoding support for some particular service. If Git were to have some kind of implicit understanding of the relationship between different repositories without you providing that information, it would require a centralized database. There's just no rational way to integrate this functionality into a distributed revision control system. Commented Feb 11, 2018 at 4:42
Starting in May 2014, it is possible to update a fork directly from GitHub. This still works as of September 2017, BUT it will lead to a dirty commit history.
- Open your fork on GitHub.
- Click on Pull Requests.
- Click on New Pull Request. By default, GitHub will compare the original with your fork, and there shouldn't be anything to compare if you didn't make any changes.
- Click switching the base if you see that link. Otherwise, manually set the base fork drop down to your fork, and the head fork to the upstream. Now GitHub will compare your fork with the original, and you should see all the latest changes.
- Create pull request and assign a predictable name to your pull request (e.g.,
Update from original
). - Scroll down to Merge pull request, but don't click anything yet.
Now you have three options, but each will lead to a less-than-clean commit history.
- The default will create an ugly merge commit.
- If you click the dropdown and choose "Squash and merge", all intervening commits will be squashed into one. This is most often something you don't want.
- If you click Rebase and merge, all commits will be made "with" you, the original PRs will link to your PR, and GitHub will display
This branch is X commits ahead, Y commits behind <original fork>
.
So yes, you can keep your repo updated with its upstream using the GitHub web UI, but doing so will sully your commit history. Stick to the command line instead - it's easy.
-
22This worked great one time. The second time this process did not work the same way: the "Switching the base" link did not show up. And when I hit "Click to create a pull request" it created a PR on the SOURCE repo. NOT what I wanted.. Commented Aug 21, 2014 at 18:14
-
32Still works (Marchi 2015), all though the "Switching the base" link is no longer there. You have to change the "Base" drop down's so both point to your fork and then you'll get a prompt to "Compare across repos", which will take you to where you want. Commented Mar 4, 2015 at 14:05
-
8April 2015. Works. Thanks. I did get "Switching to base". However, step 6 was "Create pull request" -> enter comment -> "Create pull request". End up with 1 commit ahead of original.– cartlandCommented Apr 9, 2015 at 0:08
-
5@cartland (or others) - yes, it says "This branch is 1 commit ahead of ..." Is this something to worry about? Is it possible to get rid of that message? Commented May 15, 2015 at 22:59
-
24wouldnt it be better, with a simply update or sync button! Commented Jan 24, 2017 at 3:32
Here is GitHub's official document on Syncing a fork:
Syncing a fork
The Setup
Before you can sync, you need to add a remote that points to the upstream repository. You may have done this when you originally forked.
Tip: Syncing your fork only updates your local copy of the repository; it does not update your repository on GitHub.
$ git remote -v # List the current remotes origin https://github.com/user/repo.git (fetch) origin https://github.com/user/repo.git (push) $ git remote add upstream https://github.com/otheruser/repo.git # Set a new remote $ git remote -v # Verify new remote origin https://github.com/user/repo.git (fetch) origin https://github.com/user/repo.git (push) upstream https://github.com/otheruser/repo.git (fetch) upstream https://github.com/otheruser/repo.git (push)
Syncing
There are two steps required to sync your repository with the upstream: first you must fetch from the remote, then you must merge the desired branch into your local branch.
Fetching
Fetching from the remote repository will bring in its branches and their respective commits. These are stored in your local repository under special branches.
$ git fetch upstream # Grab the upstream remote's branches 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/otheruser/repo * [new branch] master -> upstream/master
We now have the upstream's master branch stored in a local branch, upstream/master
$ git branch -va # List all local and remote-tracking branches * master a422352 My local commit remotes/origin/HEAD -> origin/master remotes/origin/master a422352 My local commit remotes/upstream/master 5fdff0f Some upstream commit
Merging
Now that we have fetched the upstream repository, we want to merge its changes into our local branch. This will bring that branch into sync with the upstream, without losing our local changes.
$ git checkout master # Check out our local master branch Switched to branch 'master' $ git merge upstream/master # Merge upstream's master into our own Updating a422352..5fdff0f Fast-forward README | 9 ------- README.md | 7 ++++++ 2 files changed, 7 insertions(+), 9 deletions(-) delete mode 100644 README create mode 100644 README.md
If your local branch didn't have any unique commits, git will instead perform a "fast-forward":
$ git merge upstream/master Updating 34e91da..16c56ad Fast-forward README.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-)
Tip: If you want to update your repository on GitHub, follow the instructions here
-
2This updates my local fork, but my fork on Github.com still says "43 commits behind". I had to use lobzik's technique to create a pull request for myself to merge the master changes into my Github.com fork. Commented Jan 23, 2015 at 17:38
-
19@MichaelMcGinnis After merging locally, you would have to push your changes to github.
git push origin master
– jumpnettCommented Feb 11, 2015 at 22:50 -
1Might be smart to push with
--follow-tags
: stackoverflow.com/a/26438076/667847– kennyCommented Nov 6, 2015 at 15:19 -
1I have to do it for all branches separately
git merge upstream/master
, then check out to develop branch and dogit merge upstream/develop
– ShobiCommented May 28, 2017 at 13:02 -
stackoverflow.com/a/14074925/470749 was helpful to me because I was getting
Permission denied (publickey). fatal: Could not read from remote repository.
when trying to fetch from Facebook's Github account upstream.– RyanCommented Jan 26, 2018 at 4:28
A lot of answers end up moving your fork one commit ahead of the parent repository. This answer summarizes the steps found here which will move your fork to the same commit as the parent.
Change directory to your local repository.
- Switch to master branch if you are not
git checkout master
- Switch to master branch if you are not
Add the parent as a remote repository,
git remote add upstream <repo-location>
- Issue
git fetch upstream
Issue
git rebase upstream/master
- At this stage you check that commits what will be merged by typing
git status
- At this stage you check that commits what will be merged by typing
Issue
git push origin master
For more information about these commands, refer to step 3.
-
14@MT: Where do you enter these commands, though? The gist of the question, as I understand it, is how to resynchronize your personal GitHub fork with the main project, and do this all from GitHub. In other words, how can you update your remote fork without a local repository?– John YCommented May 16, 2016 at 15:33
-
7@JohnY Using GitHub will always create an extra commit. You need to do all this in a shell on a local repo to avoid that extra commit. Commented Oct 14, 2016 at 21:51
If, like me, you never commit anything directly to master, which you should really, you can do the following.
From the local clone of your fork, create your upstream remote. You only need to do that once:
git remote add upstream https://github.com/whoever/whatever.git
Then whenever you want to catch up with the upstream repository master branch you need to:
git checkout master
git pull upstream master
Assuming you never committed anything on master yourself you should be done already. Now you can push your local master to your origin remote GitHub fork. You could also rebase your development branch on your now up-to-date local master.
Past the initial upstream setup and master checkout, all you need to do is run the following command to sync your master with upstream: git pull upstream master.
-
1"You could also rebase your development branch on your now up-to-date local master." How can I do this?– NielsCommented Oct 15, 2020 at 14:55
-
First run
git checkout my-dev-branch
to switch to your dev branch thengit rebase master
. You could also just rungit rebase master my-dev-branch
which basically combine those two commands. See git rebase docs.– SlionCommented Oct 16, 2020 at 8:26 -
1+1 for advising against working directly on the master of a fork, but rebasing a separate development branch. Most other top answers don't mention it, which will work fine once, but lead to headaches after that due to rewritten commits (rebase) or a merge commit that isn't on upstream (merge). Commented Oct 23, 2023 at 13:49
Foreword: Your fork is the "origin" and the repository you forked from is the "upstream".
Let's assume that you cloned already your fork to your computer with a command like this:
git clone [email protected]:your_name/project_name.git
cd project_name
If that is given then you need to continue in this order:
Add the "upstream" to your cloned repository ("origin"):
git remote add upstream [email protected]:original_author/project_name.git
Fetch the commits (and branches) from the "upstream":
git fetch upstream
Switch to the "master" branch of your fork ("origin"):
git checkout master
Stash the changes of your "master" branch:
git stash
Merge the changes from the "master" branch of the "upstream" into your the "master" branch of your "origin":
git merge upstream/master
Resolve merge conflicts if any and commit your merge
git commit -am "Merged from upstream"
Push the changes to your fork
git push
Get back your stashed changes (if any)
git stash pop
You're done! Congratulations!
GitHub also provides instructions for this topic: Syncing a fork
-
1Helped partly: Is
git remote add upstream [email protected]:original_author/project_name.git
just an alias forgit remote add upstream https://github.com/original_author/project_name.git
?– WolfCommented Jun 26, 2017 at 14:44 -
2Wolf, guessing you know this by now, but for posterity... It is the format for ssh. help.github.com/articles/configuring-a-remote-for-a-fork Commented Jan 26, 2018 at 21:02
-
2Thank you very much.
git stash
andgit stash pop
part very helpful Commented Mar 4, 2019 at 5:41 -
This worked. After git merge upstream/master, auto merge failed due to unmerged paths which I had to run git add -A then git commit -m "message" then it was up to date. Commented Dec 31, 2019 at 13:10
There are three ways one can do that: from the web UI (Option 1), from the GitHub CLI (Option 2), or from the command line (Option 3).
Option 1 - Web UI
On GitHub, navigate to the main page of the forked repository that you want to sync with the upstream repository.
Select the Fetch upstream drop-down.
- Review the details about the commits from the upstream repository, then click Fetch and merge.
Option 2 - GitHub CLI
To update the remote fork from its parent, use the gh repo sync
subcommand and supply your fork name as argument.
$ gh repo sync owner/cli-fork
If the changes from the upstream repository cause conflict then the GitHub CLI can't sync. You can set the -force
flag to overwrite the destination branch.
Option 3 - Command Line
Before syncing one's fork with an upstream repository, one must configure a remote that points to the upstream repository in Git.
1 Open Git Bash.
2 Change the current working directory to your local project.
3 Fetch the branches and their respective commits from the upstream repository. Commits to BRANCHNAME will be stored in the local branch upstream/BRANCHNAME.
$ 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] main -> upstream/main
4 Check out your fork's local default branch - in this case, we use main.
$ git checkout main
> Switched to branch 'main'
5 Merge the changes from the upstream default branch - in this case, upstream/main - into your local default branch. This brings your fork's default branch into sync with the upstream repository, without losing your local changes.
$ git merge upstream/main
> Updating a422352..5fdff0f
> Fast-forward
> README | 9 -------
> README.md | 7 ++++++
> 2 files changed, 7 insertions(+), 9 deletions(-)
> delete mode 100644 README
> create mode 100644 README.md
If one's local branch didn't have any unique commits, Git will instead perform a "fast-forward":
$ git merge upstream/main
> Updating 34e91da..16c56ad
> Fast-forward
> README.md | 5 +++--
> 1 file changed, 3 insertions(+), 2 deletions(-)
Note: Syncing one's fork only updates one's local copy of the repo. To update one's fork on GitHub.com, one must push ones changes.
Source: GitHub Docs - Syncing a fork
-
1This one worked just fine to me. Github GUI tooling is really good Commented Nov 29, 2021 at 13:06
GitHub has now introduced a feature to sync a fork with the click of a button.
Go to your fork, click on Fetch upstream
, and then click on Fetch and merge
to directly sync your fork with its parent repo.
You may also click on the Compare
button to compare the changes before merging.
Reference: GitHub's documentation
-
I tried this and no PR was created, cool! And if your branch can be synced with a fast-forward merge, no divergence will occur.– li kiCommented May 7, 2021 at 23:44
-
3For now, this function will first compare the branch name between the original and the forked repos. If the same name is found, the upstream of the branch in the fork is the branch with the same name in the original; if it is not found, the upstream will be the default branch (HEAD) of the original. This works fine in most cases, but if some branch modification has occurred in the original repo (e.g., adding or deleting a branch with the same name which already exists in the forked repo, or changing the default branch), the result of the sync may not match you expectations.– li kiCommented May 8, 2021 at 0:31
Since November 2013 there has been an unofficial feature request open with GitHub to ask them to add a very simple and intuitive method to keep a local fork in sync with upstream:
https://github.com/isaacs/github/issues/121
Note: Since the feature request is unofficial it is also advisable to contact [email protected]
to add your support for a feature like this to be implemented. The unofficial feature request above could be used as evidence of the amount of interest in this being implemented.
As of the date of this answer, GitHub has not (or shall I say no longer?) this feature in the web interface. You can, however, ask [email protected]
to add your vote for that.
In the meantime, GitHub user bardiharborow has created a tool to do just this: https://upriver.github.io/
Source is here: https://github.com/upriver/upriver.github.io
-
2While I do find the tool a good idea the reality is that's BROKEN. It did load only 20 repos from my account and even the footer redirects to a website that does not exists. If that's fixed I will be a big advocate.– sorinCommented Oct 28, 2016 at 16:07
-
2As of today, I have successfully used upriver to sync a fork with the upstream repo, so it's working for my purposes and I will continue to use it. Commented Jul 17, 2017 at 2:55
-
1@sorin These 20 repo/branch limitation (rather, it is 30 now) comes from the GitHub default paging settings. There needs to be some adaptions to the code in order to handle this.– AndreasCommented Jan 18, 2018 at 8:19
If you are using GitHub for Windows or Mac then now they have a one-click feature to update forks:
- Select the repository in the UI.
- Click "Update from user/branch" button the top.
-
3Step by step: github.com/desktop/desktop/issues/1785#issuecomment-483011281 Commented Mar 25, 2020 at 17:03
$ git remote add upstream https://github.com/....
$ git pull upstream main
$ git push
-
This is the easy one, do we need to fetch the upstream before pulling it? Commented Aug 26, 2022 at 11:54
Actually, it is possible to create a branch in your fork from any commit of the upstream in the browser:
- Open
https://github.com/<repo>/commits/<hash>
, where repo is your fork, and hash is full hash of commit which you can find in the upstream web interface. For example, I can open https://github.com/max630/linux/commits/0aa0313f9d576affd7747cc3f179feb097d28990, which points tolinux
master
as time of writing. - Click on the "Tree: ...." button.
- Type name of the new branch and press Enter
You can then fetch that branch to your local clone, and you won't have to push all that data back to GitHub when you push edits on top of that commit. Or use the web interface to change something in that branch.
How it works (it is a guess, I don't know how exactly GitHub does it): forks share object storage and use namespaces to separate users' references. So you can access all commits through your fork, even if they did not exist by the time of forking.
-
3This is great! This avoids the totally pointless upload of those commits to github.– RotsorCommented Mar 13, 2017 at 3:34
Follow the below steps. I tried them and it helped me.
Checkout to your branch
Syntax: git branch yourDevelopmentBranch
Example: git checkout master
Pull source repository branch for getting the latest code
Syntax: git pull https://github.com/tastejs/awesome-app-ideas master
Example: git pull https://github.com/ORIGINAL_OWNER/ORIGINAL_REPO.git BRANCH_NAME
-
1If you're using GitHub, you might also want to push your changes to your GitHub branch.
git push HttpsForYourForkOfTheRepo BRANCH_NAME
Commented Jan 22, 2016 at 19:34
I update my forked repos with this one line:
git pull https://github.com/forkuser/forkedrepo.git branch
Use this if you dont want to add another remote endpoint to your project, as other solutions posted here.
-
2Are there limitations on this? i.e. does it apply only to cases where you have not added commits, merges, pull requests, or had pull requests merged into upstream since the last update?– LightCCCommented Sep 11, 2017 at 7:30
-
1it does work like a normal pull from a remote branch. If you did X commits on your local repo and now you are Y commits behind the original repo, it will bring the Y commits to your local branch and, probably, get you some conflicts to resolve. Commented Sep 11, 2017 at 20:23
-
2
-
1This is a perfect solution if you don't have to pull many times from the original repo, or the project forked is relatively simple. Commented Apr 28, 2020 at 22:41
As a complement to this answer, I was looking for a way to update all remote branches of my cloned repo (origin) from upstream branches in one go. This is how I did it.
This assumes you have already configured an upstream remote pointing at the source repository (where origin was forked from) and have synced it with git fetch upstream
.
Then run:
for branch in $(git ls-remote --heads upstream|sed 's#^.*refs/heads/##'); do git push origin refs/remotes/upstream/$branch:refs/heads/$branch; done
The first part of this command lists all heads in the upstream remote repo and removes the SHA-1 followed by refs/heads/
branch name prefix.
Then for each of these branches, it pushes the local copy of the upstream remote tracking branch (refs/remotes/upstream/<branch>
on local side) directly to the remote branch on origin (refs/heads/<branch>
on remote side).
Any of these branch sync commands may fail for one of two reasons: either the upstream branch have been rewritten, or you have pushed commits on that branch to your fork. In the first case where you haven't committed anything to the branch on your fork it is safe to push forcefully (Add the -f switch; i.e. git push -f
in the command above). In the other case this is normal as your fork branch have diverged and you can't expect the sync command to work until your commits have been merged back into upstream.
The "Pull" app is an automatic set-up-and-forget solution. It will sync the default branch of your fork with the upstream repository.
Visit the URL, click the green "Install" button and select the repositories where you want to enable automatic synchronization.
The branch is updated once per hour directly on GitHub, on your local machine you need to pull the master branch to ensure that your local copy is in sync.
-
2Please note that with the basic setup, you can lose the changes made in your forked repository. To keep the changes, set up a config file and specify a
mergemethod
. More on this here Commented Nov 21, 2019 at 3:06 -
1I did note that the basic setup sends pull requests and merges them (as opposed to what's stated in the documentation). This is slightly annoying but solves the data loss problem?– krlmlrCommented Nov 21, 2019 at 9:24
If you set your upstream. Check with git remote -v
, then this will suffice.
git fetch upstream
git checkout master
git merge --no-edit upstream/master
git push
When you have cloned your forked repository, go to the directory path where your clone resides and the few lines in your Git Bash Terminal.
$ cd project-name
$ git remote add upstream https://github.com/user-name/project-name.git
# Adding the upstream -> the main repo with which you wanna sync
$ git remote -v # you will see the upstream here
$ git checkout master # see if you are already on master branch
$ git fetch upstream
And there you are good to go. All updated changes in the main repository will be pushed into your fork repository.
The "fetch" command is indispensable for staying up-to-date in a project: only when performing a "git fetch" will you be informed about the changes your colleagues pushed to the remote server.
You can still visit here for further queries
Android Studio now has learned to work with GitHub fork repositories (you don't even have to add "upstream" remote repository by console command).
Open menu VCS → Git
And pay attention to the two last popup menu items:
Rebase my GitHub fork
Create Pull Request
Try them. I use the first one to synchronize my local repository. Anyway the branches from the parent remote repository ("upstream") will be accessible in Android Studio after you click "Rebase my GitHub fork", and you will be able to operate with them easily.
(I use Android Studio 3.0 with "Git integration" and "GitHub" plugins.)
How to update your forked repo on your local machine?
First, check your remote/master
git remote -v
You should have origin and upstream. For example:
origin https://github.com/your___name/kredis.git (fetch)
origin https://github.com/your___name/kredis.git (push)
upstream https://github.com/rails/kredis.git (fetch)
upstream https://github.com/rails/kredis.git (push)
After that go to main:
git checkout main
and merge from upstream to main:
git merge upstream/main
Assuming your fork is https://github.com/me/foobar and original repository is https://github.com/someone/foobar
Visit https://github.com/me/foobar/compare/master...someone:master
If you see green text
Able to merge
then press Create pull requestOn the next page, scroll to the bottom of the page and click Merge pull request and Confirm merge.
Use this code snippet to generate link to sync your forked repository:
new Vue ({
el: "#app",
data: {
yourFork: 'https://github.com/me/foobar',
originalRepo: 'https://github.com/someone/foobar'
},
computed: {
syncLink: function () {
const yourFork = new URL(this.yourFork).pathname.split('/')
const originalRepo = new URL(this.originalRepo).pathname.split('/')
if (yourFork[1] && yourFork[2] && originalRepo[1]) {
return `https://github.com/${yourFork[1]}/${yourFork[2]}/compare/master...${originalRepo[1]}:master`
}
return 'Not enough data'
}
}
})
<script src="https://cdnjs.cloudflare.com/ajax/libs/vue/2.5.17/vue.js"></script>
<div id="app">
Your fork URL: <input size=50 v-model="yourFork" /> <br />
Original repository URL: <input v-model="originalRepo" size=50 /> <br />
Link to sync your fork: <a :href="syncLink">{{syncLink}}</a>
</div>
-
2You deserve an award. Nice answer. This worked for me and I think is pretty normal. I went and did a git pull after on my local repo and updated. Your instructions are good. To someone new, you will have to play with the dropdown lists on the compare screen first to get the arrow to go the correct direction. This gives you the github.com/myside...theirside correct link in the address bar.– BeeeaaarCommented Mar 15, 2021 at 4:24
I would like to add on to @krlmlr's answer.
Initially, the forked repository has one branch named : master
. If you are working on a new feature or a fix, you would generally create a new branch feature
and make the changes.
If you want the forked repository to be in sync with the parent repository, you could set up a config file(pull.yml
) for the Pull app (in the feature branch), like this:
version: "1"
rules:
- base: feature
upstream: master
mergeMethod: merge
- base: master
upstream: parent_repo:master
mergeMethod: hardreset
This keeps the master
branch of the forked repo up-to-date with the parent repo. It keeps the feature
branch of the forked repo updated via the master
branch of the forked repo by merging the same. This assumes that the feature
branch is the default branch which contains the config file.
Here two mergemethods
are into play, one is hardreset
which helps force sync changes in the master
branch of the forked repo with the parent repo and the other method is merge
. This method is used to merge changes done by you in the feature
branch and changes done due to force sync in the master
branch. In case of merge conflict, the pull app will allow you to choose the next course of action during the pull request.
You can read about basic and advanced configs and various mergemethods
here.
I am currently using this configuration in my forked repo here to make sure an enhancement requested here stays updated.
That depends on the size of your repository and how you forked it.
If it's quite a big repository you may have wanted to manage it in a special way (e.g. drop history). Basically, you can get differences between current and upstream versions, commit them and then cherry pick back to master.
Try reading this one. It describes how to handle big Git repositories and how to upstream them with latest changes.
If you want to keep your GitHub forks up to date with the respective upstreams, there also exists this probot program for GitHub specifically: https://probot.github.io/apps/pull/ which does the job. You would need to allow installation in your account and it will keep your forks up to date.
If you use GitHub Desktop, you can do it easily in just 6 steps (actually only 5).
Once you open Github Desktop and choose your repository,
- Go to History tab
- Click on the search bar. It will show you all the available branches (including upstream branches from parent repository)
- Select the respective upstream branch (it will be upstream/master to sync master branch)
- (OPTIONAL) It will show you all the commits in the upstream branch. You can click on any commit to see the changes.
- Click Merge in
master
/branch-name
, based on your active branch. - Wait for GitHub Desktop to do the magic.
Checkout the GIF below as an example:
Use these commands (in lucky case)
git remote -v
git pull
git fetch upstream
git checkout master
git merge upstream/master --no-ff
git add .
git commit -m"Sync with upstream repository."
git push -v
-
If there's a conflict then one'd only need to resolve those after the merge command and mark the resolves by
git add
command for the conflicted files. Also, if the repo in question is a forked one someone has to first define theupstream
:git remote add upstream https://...git
where the git is for the repo which got forked. Commented Jun 29, 2021 at 21:11 -
Also, GitHub's PR (the UI Fetch button creates the PR against the fork repo) is a shitshow if there's a conflict. I'd rather just go with these manual steps. Commented Jun 29, 2021 at 21:12
There are two main things on keeping a forked repository always update for good.
1. Create the branches from the fork master and do changes there.
So when your Pull Request is accepted then you can safely delete the branch as your contributed code will be then live in your master of your forked repository when you update it with the upstream. By this your master will always be in clean condition to create a new branch to do another change.
2. Create a scheduled job for the fork master to do update automatically.
This can be done with cron. Here is for an example code if you do it in linux.
$ crontab -e
put this code on the crontab file
to execute the job in hourly basis.
0 * * * * sh ~/cron.sh
then create the cron.sh
script file and a git interaction with ssh-agent and/or expect as below
#!/bin/sh
WORKDIR=/path/to/your/dir
REPOSITORY=<name of your repo>
MASTER="[email protected]:<username>/$REPOSITORY.git"
[email protected]:<upstream>/<name of the repo>.git
cd $WORKDIR && rm -rf $REPOSITORY
eval `ssh-agent` && expect ~/.ssh/agent && ssh-add -l
git clone $MASTER && cd $REPOSITORY && git checkout master
git remote add upstream $UPSTREAM && git fetch --prune upstream
if [ `git rev-list HEAD...upstream/master --count` -eq 0 ]
then
echo "all the same, do nothing"
else
echo "update exist, do rebase!"
git reset --hard upstream/master
git push origin master --force
fi
cd $WORKDIR && rm -rf $REPOSITORY
eval `ssh-agent -k`
Check your forked repository. From time to time it will always show this notification:
This branch is even with
<upstream>
:master.
rm -rf oldrepository
git clone ...
There may be subtler options, but it is the only way that I have any confidence that my local repository is the same as upstream.
-
1WARNING!!! - You will lose your branches if you've created any Commented Sep 30, 2022 at 7:35