libgit2 returned: Refspec 'refs/heads/origin/HEAD' not found error in TortoiseGit

I got this error when starting up TortoiseGit:

Error dialog screenshot

  • GIT — push everything to remote server, but with only with one log entry
  • Git pull --all behaving differently on osx / linux
  • Git - corrupted object?
  • Cherrypick commit orders
  • Re-use conflict resolution with Git
  • Automate Release Notes - Jenkins and Github
  • Could not get all refs.
    libgit2 returned: Refspec ‘refs/heads/origin/HEAD’ not found

    While annoying, it does not prevent me from using TortoiseGit. However, I’d like to make it go away, because it is, well, annoying. How do I fix this?

  • Prevent old code from showing up when opening ST3
  • heroku:ERROR: File '/composer.phar' isn't executable; please 'chmod +x'!
  • reverting to a previous commit using checkout removes omits some older commits git/smartgit
  • Git S3 KeyError
  • Is it possible to cleanup a bare repo?
  • How to create branch for the single file?
  • One Solution collect form web for “libgit2 returned: Refspec 'refs/heads/origin/HEAD' not found error in TortoiseGit”

    Updated Answer

    So it turns out that, for the purpose of updating a local repo’s view of which branch <remote>/HEAD points to, you can have git automatically fetch that information from the remote and set it locally for you, instead of having to manually set it with git symbolic-ref like in my old solution above:

    git remote set-head <remote> --auto
    
    # Or shorter
    git remote set-head <remote> -a
    

    Note that this command doesn’t actually change what the default branch is on the remote repo itself. For that, you’ll probably need to use git symbolic-ref directly on the remote repo, if you have access to it.

    • Documentation for git remote set-head.

    Old Answer

    The problem that the error message refers to is that apparently libgit2 is trying to read the remote default branch pointed to by refs/remotes/origin/HEAD, but the remote branch doesn’t exist, thus the error.

    Using git branch -a, my local repo thinks that origin/develop is the remote default branch:

    remotes/origin/HEAD -> origin/develop
    

    At one point origin/develop was indeed the default branch in my origin repo on GitHub, but it isn’t any longer, the master branch is. The develop branch was deleted from origin since it was no longer needed.

    So I fixed this by manually updating the local reference origin/HEAD to point to the new default branch on origin:

    git symbolic-ref refs/remotes/origin/HEAD refs/remotes/origin/master
    

    Or if I wanted to also add a message to the reflog for refs/remotes/origin/HEAD:

    git symbolic-ref -m "Update to new remote default branch" \
    refs/remotes/origin/HEAD refs/remotes/origin/master
    

    This resolved the issue. See also:

    1. Documentation for git symbolic-ref.
    2. Git: Correct way to change Active Branch in a bare repository?.
    3. How do I change a Git remote HEAD to point to something besides “master”.
    Git Baby is a git and github fan, let's start git clone.