889

Using git 1.6.4.2, when I tried a git pull I get this error:

error: unable to resolve reference refs/remotes/origin/LT558-optimize-sql: No such file or directory
From git+ssh://remoteserver/~/misk5
 ! [new branch]      LT558-optimize-sql -> origin/LT558-optimize-sql  (unable to update local ref)
error: unable to resolve reference refs/remotes/origin/split-css: No such file or directory
 ! [new branch]      split-css  -> origin/split-css  (unable to update local ref)

I've tried git remote prune origin, but it didn't help.

2

39 Answers 39

1377

Try cleaning-up your local repository with:

$ git gc --prune=now
$ git remote prune origin

man git-gc(1):

git-gc - Cleanup unnecessary files and optimize the local repository

git gc [--aggressive] [--auto] [--quiet] [--prune=<date> | --no-prune]

       Runs a number of housekeeping tasks within the current repository, such as compressing file revisions
       (to reduce disk space and increase performance) and removing unreachable objects which may have been
       created from prior invocations of git add.

       Users are encouraged to run this task on a regular basis within each repository to maintain good disk
       space utilization and good operating performance.

man git-remote(1):

git-remote - manage set of tracked repositories

git remote prune [-n | --dry-run] <name>

           Deletes all stale remote-tracking branches under <name>. These stale branches have already been
           removed from the remote repository referenced by <name>, but are still locally available in
           "remotes/<name>".            
11
  • 172
    Why does this work? What is the problem that it fixes?
    – Ikke
    Feb 14, 2017 at 14:22
  • 8
    The second command worked for me. Apparently I had a broken reference to a remote branch that was just created. Not sure how it happened, but glad it was a simple fix. Thanks Vitek!
    – JGTaylor
    Jul 20, 2017 at 16:56
  • 2
    This worked perfectly! I'd also love an explanation of what this does and why this worked. Thanks!
    – ArielSD
    Sep 18, 2018 at 18:31
  • 7
    Will the git remote prune origin command run on my local working copy or on the remote repository? Dec 17, 2018 at 11:48
  • 4
    @user1438038 It should not remove any branches and only update remote ref's in your local working copy. More info here: stackoverflow.com/questions/20106712/…
    – Zengineer
    Mar 1, 2019 at 22:55
811

Happened to me as well. In my case, the bad ref was master, and I did the following:

rm .git/refs/remotes/origin/master
git fetch

This made git restore the ref file. After that everything worked as expected again.

17
  • 2
    I did the same thing, and it solved my problem. When I opened the file in Notepad++, it was clearly corrupted.
    – theMayer
    Oct 26, 2013 at 14:52
  • 105
    make sure you choose the file that is giving you problems instead of master Jan 20, 2014 at 19:10
  • 9
    @bia.migueis: it's not gonna damage anythin if you accidentally remove master as well though - it'll just get updated next fetch too.
    – naught101
    Jul 7, 2014 at 0:10
  • 2
    If it is a submodule, it might be slightly tricky to find the ref. First check if .git is a folder by doing ls -la if not, see the contents of the file .git file to find the actual .git folder in which the refs are. .git file contents in my case: gitdir: ../.git/modules/my-submodule-name
    – CCoder
    Nov 30, 2016 at 7:23
  • 2
    Twice now in the past year I've come back to have to fix this and again, this is the only fix that actually works.
    – Ted
    Apr 16, 2020 at 17:04
180

This did the job for me:

git gc --prune=now
4
  • git gc docs are here
    – BigRon
    Sep 21, 2018 at 19:41
  • 1
    Worked for me too. Didn't need to run git remote prune origin
    – Airwavezx
    Jan 17, 2019 at 8:33
  • Had to move the bad references that the terminal was mentioning out of the .git folder before that command would run, but after that this command ran, and I was able to continue merrily on my coding journey!
    – TripWire
    Nov 12, 2020 at 1:37
  • Running this command accused the problem in my case: fatal: bad object refs/remotes/origin/HEAD fatal: failed to run repack so I ran rm .git/refs/remotes/origin/HEAD and later git gc --prune=now and now the repo is clean as new. Mar 1, 2021 at 12:57
112

For me, it worked to remove the files that are throwing errors from the folder .git/refs/remotes/origin/.

6
  • that did it! But just out of curiosity do you know why this error came? (everything was working fine and then suddenly one day this error popped). And also do you know how deleting the file solved it?
    – Shreyans
    Apr 2, 2016 at 11:06
  • Good to hear this also fixed it for you. To be honest i have no idea what caused the error to appear. My thought was that one of the files in the folder had gone out of sync. Since none of the other fixes i found worked for me i used this as a last resort. Apr 4, 2016 at 9:31
  • 3
    One of the possible causes may be the system crash as I described in my answer. Many Git GUI applications periodically run Git on your repo (to refresh the status) and if your system crashes during Git is manipulating with the references, they may end up rewritten with NULLs. Jul 24, 2018 at 17:00
  • 1
    My system crashed just as a sync operation was about to complete and this helped.
    – Padmika
    Nov 27, 2020 at 2:37
  • 1
    I forced shutdown my laptop without closing all apps. It caused the issue. Deleting the C:\git\repo1\.git\logs\refs\remotes\origin helped
    – Chinmoy
    Feb 28 at 7:11
102

I just would like to add one of the possible causes of a broken Git reference.

Possible root cause

On my system (Windows 7 64-bit), when a BSOD happens, some of the stored reference files (most likely currently opened/being written into when the BSOD happened) are overwritten with NULL characters (ASCII 0).

As others mentioned, to fix it, it's enough to just delete those invalid reference files and re-fetch or re-pull the repository.

Example

Error message:

cannot lock ref 'refs/remotes/origin/some/branch': unable to resolve reference 'refs/remotes/origin/some/branch': reference broken

Solution:

Delete the reference refs/remotes/origin/some/branch which is stored in the file %repo_root%/.git/refs/remotes/origin/some/branch.

4
  • 5
    Same scenario on Windows 10 64bit - working in a git repo when BSOD happens. error: cannot lock ref 'refs/remotes/origin/master': unable to resolve reference 'refs/remotes/origin/master': reference broken. Trying to git pull after deleting the first file returned fatal: update_ref failed for ref 'HEAD': cannot lock ref 'HEAD': unable to resolve reference 'refs/heads/master': reference broken. After deleting the second file git pull origin master was successful.
    – c.j.mcdonn
    Sep 19, 2018 at 18:50
  • Simplest solution so far
    – George
    Sep 16, 2021 at 14:30
  • 1
    Had a BSOD. This solved my problem.
    – ThomasMX
    Nov 16, 2021 at 14:37
  • this is what worked for me after all Mar 18, 2022 at 13:14
88

Explanation: It appears your remote repo (in GitHub / BitBucket) branches were removed ,though your local references were not updated and pointing to non existent references.

In order to solve this issue:

git fetch --prune
git fetch --all
git pull

For extra reading - Reference from Git documentation :

git-fetch - Download objects and refs from another repository

--all Fetch all remotes.

--prune After fetching, remove any remote tracking branches which no longer exist on the remote.

0
87

Go to under flutter folder and then,

Try it:

git gc --prune=now

git remote prune origin

git pull
3
  • 40
    While this might answer the authors' question, it lacks some explaining words and/or links to documentation. Raw code snippets are not very helpful without some phrases around them. You may also find how to write a good answer very helpful. Please edit your answer. Nov 23, 2018 at 21:57
  • Exactly the point. It's not enough to right the code and that's it. I hope there's an explanation
    – Musikero31
    Jun 15, 2019 at 4:57
  • 1
    git gc --prune=now updates local repository while deleting unnecessary files. It works for me fine. Apr 19, 2020 at 18:39
53

Execute the following commands:

rm .git/refs/remotes/origin/master

git fetch

git branch --set-upstream-to=origin/master

Just in case, if you need to know what is .git/refs/remotes/origin/master, you would read the Remotes section in Git References.

0
51

git fetch --prune fixed this error for me:

[marc.zych@marc-desktop] - [~/code/driving] - [Wed May 10, 02:58:25]
[I]> git fetch
error: cannot lock ref 'refs/remotes/origin/user/janek/integration/20170505': 'refs/remotes/origin/user/janek/integration' exists; cannot create 'refs/remotes/origin/user/janek/integration/20170505'
From github.com:zooxco/driving
 ! [new branch]            user/janek/integration/20170505 -> origin/user/janek/integration/20170505  (unable to update local ref)
From github.com:zooxco/driving
[marc.zych@marc-desktop] - [~/code/driving] - [Wed May 10, 02:58:30]
[I]> git fetch --prune
 - [deleted]               (none)     -> origin/user/janek/integration

This assumes that the offending branch was deleted on the remote, though.

You can also add this to ~/.gitconfig to automatically prune when running git fetch:

[fetch]
    prune = true
2
  • Your example seems incomplete: it doesn't show the --prune that I can see. Also proTip: remove useless password prompts after pasting examples.
    – MarkHu
    Aug 4, 2017 at 22:28
  • You're absolutely right - I left off the output from the fetch command but I just put it into the example. Thanks for the tip on removing the password prompt too!
    – marczych
    Aug 5, 2017 at 18:17
49

In my case, the problem was solved after I've deleted all the remove reference files under the directory .git.

If you look at the message, it would tell you which files you need to delete (specifically).

The files to delete sit under .git/refs/remotes.

I've just deleted all the files there, and ran gc prune

git gc --prune=now

After that, everything works just fine.

2
  • In my case I just delete .git/refs/remotes and then update and push over server and it worked. Nov 7, 2017 at 10:20
  • Thanks Uri. In my case I just deleted files under refs/remotes/origin/feature and I simply did - git pull
    – Deepboy
    Apr 17, 2019 at 14:58
46

I had this same issue and solved it by going to the file it was erroring on:

\repo\.git\refs\remotes\origin\master

This file was full of nulls, I replaced it with the latest ref from github.

1
  • 3
    Had the same issue, but the file .git/refs/remotes/origin/master was just empty. Solved the problem by removing it.
    – zinovyev
    Dec 30, 2016 at 16:05
28

If this error “unable to update local ref” is reoccurring, even after applying either the answer by Vojtech Vitek or Michel Krämer you may you may have a bad ref on your local AND master repository.

In this case you should apply both fix's without pulling or pushing in between ...

rm .git/refs/remotes/origin/master
git fetch
git gc --prune=now
git remote prune origin

A permanent resolution for me was only achieved after applying both fix's before push/pull.

1
  • 3
    Thanks for this. note that I replaced 'master' with the branch which was failing eg - rm .git/refs/remotes/origin/develop Jan 2, 2020 at 21:46
18

For me, I solved it this way:

rm .git/refs/remotes/origin/master
git fetch

After that I get this message from github.

There is no tracking information for the current branch

So next I did to fix this was:

git branch --set-upstream-to=origin/master master
git pull
15

To Answer this in very short, this issue comes when your local has some information about the remote and someone changes something which makes remote and your changes unsync.

I was getting this issue because someone has deleted remote branch and again created with the same name.

For dealing with such issues, do a pull or fetch from remote.

git remote prune origin

or if you are using any GUI, do a fetch from remote.

enter image description here

8

Try this:

git pull origin Branch_Name

Branch_Name, the branch which you are currently on.

If you do only a git pull, it pulls all other created branch name as well.

So is the reason you are getting this:

! [new branch]      split-css  -> origin/split-css  (unable to update local ref)
7

Error: cannot lock ref" simply means information in /refs are corrupted and Git cannot continue to create index.lock file.

Quick fix : Remove and re-add remote.

1- Copy the SSH git URL of your existing remote. You can print it to the terminal using this command:

git remote -v

2- Remove the remote from your local git repo:

git remote rm origin

3- Add the remote back to your local repo:

git remote add origin [email protected]:your-username/repo-name.git

4- Prune remote origin Users across online forums have reported that the command below worked for them:

git remote prune origin

5- Clean up and optimize local repository git gc --prune=now

You can find more info on this article: https://linuxpip.org/git-error-cannot-lock-ref/

1
  • 1
    This is the only answer that worked for me. Did a "git fetch" afterwards, then when I tried the "git pull", it failed due to no tracking info. Had to first execute "git branch --set-upstream-to origin/master master", the finally redo the "git pull". Jun 23 at 3:23
6
$ rm .git/refs/remotes/origin/master

$ git fetch

From bitbucket.org:xx/mkyong-tutorials

df0eee8..3f7af90  master     -> origin/master

$ git pull

Already up to date.

5

I was able to work with

git remote update --prune
4

delete file for particular branch manually from your project

.git/refs/remotes/origin/master
 git gc --prune=now
 git pull
1
  • 1
    git prune work for me. thanks for a straightforward answer Nov 17, 2022 at 4:45
3

Tried these but didn't work for me:

$ git gc --prune=now
$ git remote prune origin
$ git fetch --prune

I had to get this fixed by deleting the local folder and cloning again.

2

For me, I had a local branch named feature/phase2 and the remote branch was named feature/phase2/data-model. The naming conflict was the cause of the problem, so I deleted my local branch (you could rename it if it had anything you needed to keep)

1
  • Same issue here - ours also was a Mac/PC case-naming issue, which made it tricky to spot (one name was capitalized, the other not - and it worked on the PC, but not Mac)
    – rocksteady
    Jun 10, 2019 at 14:55
2

If git gc --prune=now dosen't help you. (bad luck like me)

What I did is remove the project in local, and re clone the whole project again.

1
  • This is a "I got an error message so I bought a new computer"-approach which I didn't expect to get any upvotes on this website. Jun 4, 2019 at 7:51
2

I'm using Tower and for some reason my folder name was .git/refs/remotes/origin/Github. Changing it to lowercase .git/refs/remotes/origin/github solved the issue.

2

When it is caused by Google Drive desktop.ini files

Google Drive client for Windows creates desktop.ini files in each folder. If your git repository is in a directory that is being synced with Google Drive, then the desktop.ini files will cause the git repository to fail with something like:

cannot lock ref 'refs/remotes/origin/desktop.ini': unable to resolve reference 'refs/remotes/origin/desktop.ini': reference broken

To solve this error you might want to delete the desktop.ini files in your git repository.

If you have WSL setup, then you can use the following command to delete the desktop.ini files:

Note: ⚠️ This command will delete all desktop.ini files in all .git directories in your <project_directory>.

find <project_directory> -type d -name .git -print0 | xargs -0 -I {} find {} -type f -name desktop.ini -print0 | xargs -0 -I {} rm -vf {}

If you just want to delete the desktop.ini files in a specific .git directory, then you can use the following command:

find <.git_directory> -type f -name desktop.ini -print0 | xargs -0 -I {} rm -vf {}
1

I had same issue. i follow following steps

1)switch your branch which having issue to other branch

2) delete that branch

3) checkout again.

Note:- You can stash you uncommitted changes and put it back again.

1

Got this issue when trying to clone from a git bundle created file, none of the other answers worked because I couldn't clone the repo (so git gc and removing/editing files was out of the question).

There was however another way to fix this - the source file of a .bundle file was begining with:

# v2 git bundle
9a3184e2f983ba13cc7f40a820df8dd8cf20b54d HEAD
9a3184e2f983ba13cc7f40a820df8dd8cf20b54d refs/heads/master
9a3184e2f983ba13cc7f40a820df8dd8cf20b54d refs/heads/master

PACK.......p..x...Kj.0...: (and so on...)

Simply removing the fourth line with vim fixed the issue.

1

I used git prune origin and that did the work.

0
1

Writing down a specific case that might cause this problem.

One day I pushed a branch named "feature/subfeature", while having "feature" branch on remote.

That operation worked fine without any error on my side, but when my co-workers fetched and/or pulled any branch, they all had the exact same error message unable to update local ref, cannot lock ref 'refs/remotes/origin/feature/subfeature.

This was solved by deleting feature branch on remote(git push --delete origin feature) and then running git remote prune origin on my co-workers' repo, which generated messages including * [pruned] origin/feature.

So, my guess is git fetch was trying to create subfeature ref in feature folder on git internally(.git/...), but creating folder failed because there was feature ref already.

1

Try this: git branch --unset-upstream

I was facing the problem earlier but I just solved it when I saw this command on the terminal.

1
 # remove the reference file of the branch "lost"
 rm -fv ./.git/refs/remotes/origin/feature/v1.6.9-api-token-bot-reader
 
 # git clear everything 
 clear ; git reset HEAD --hard ; git clean -xdf ; 

 # subdue the current branch and pull all changes from the remote
 clear ; git fetch --all -p ; git pull --all --rebase ; clear ; git branch -a

 # git will "know" how-to handle the issue from now on
 #     From github.com:futurice/senzoit-www-server
 # * [new branch]      feature/v1.6.9-api-token-bot-reader ->
 # origin/feature/v1.6.9-api-token-bot-reader

 # and push your local changes
 git push

Not the answer you're looking for? Browse other questions tagged or ask your own question.