...
Eroare Git · Push, remote și GitHub

remote: error: refusing to update checked out branch: refs/heads/main

Pe scurt

Faci push într-un repository obișnuit (cu folder de lucru) chiar pe branch-ul deschis acolo, iar Git refuză ca să nu-i strice fișierele. Folosește ca server un repository bare (git init --bare) sau un serviciu ca GitHub; pe termen scurt, trece repository-ul de pe server pe alt branch.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Un repository creat cu git init are un folder de lucru și un branch deschis (de obicei main). Dacă cineva ar face push în acel branch, istoricul s-ar muta, dar fișierele din folder și staging-ul de acolo ar rămâne pe versiunea veche, ca și cum cineva ar fi anulat toate modificările. De aceea Git refuză: remote: error: refusing to update checked out branch: refs/heads/main, iar la final vezi ! [remote rejected] main -> main (branch is currently checked out).

Eroarea apare când folosești un folder obișnuit ca „server”: un folder partajat, un stick, alt folder de pe același calculator, un server SSH pe care ai rulat git init. Repository-urile care primesc push trebuie să fie bare (git init --bare server.git), adică fără folder de lucru, exact cum sunt cele de pe GitHub.

De ce apare: cauzele frecvente

1Serverul e un repository obișnuit

Greșit
BASH
ssh server "git init /srv/proiect"
git push origin main
Corect
BASH
ssh server "git init --bare /srv/proiect.git"
git remote set-url origin server:/srv/proiect.git
git push origin main

Un repository bare nu are folder de lucru, deci nu are ce să strice un push.

2Ai clonat un folder local și faci push înapoi

Greșit
BASH
git clone ~/server ~/proiect
cd ~/proiect
git push origin main
Corect
BASH
git clone --bare ~/server ~/server.git
git remote set-url origin ~/server.git
git push origin main

Faci o copie bare a serverului și îl folosești pe aceea ca remote.

3Soluție rapidă pe un server de test

Greșit
BASH
git push origin main   # main e deschis pe server
Corect
BASH
cd ~/server && git switch -c lucru
cd ~/proiect && git push origin main

Dacă main nu mai e branch-ul deschis pe server, push-ul în el e permis. Fișierele din folderul serverului rămân pe lucru.

Repară tu

Repară eroarea, direct în pagină

Folosești folderul ~/server (un repository obișnuit, pe main) ca server de test, iar ~/proiect e clona lui. git push origin main din ~/proiect e respins cu refusing to update checked out branch. Nimeni nu lucrează în ~/server: trece-l pe un branch nou, lucru, apoi urcă din nou main din ~/proiect.

Indiciu

Push-ul în main e refuzat doar cât timp main e deschis în folderul serverului.

Alte forme ale mesajului

  • ! [remote rejected] main -> main (branch is currently checked out)
  • remote: error: By default, updating the current branch in a non-bare repository remote: is denied, because it will make the index and work tree inconsistent

Cum o eviți pe viitor

  • Repository-urile care primesc push le creezi mereu cu git init --bare (sau git clone --bare), cu nume terminat în .git.
  • Pentru proiecte în echipă, folosește un serviciu de găzduire (GitHub, GitLab, Bitbucket), unde repository-urile sunt bare.
  • Nu modifica receive.denyCurrentBranch decât dacă știi exact cum se actualizează folderul de pe server (de exemplu updateInstead pentru un site simplu).

Întrebări frecvente

Ce e un repository bare?

Un repository fără folder de lucru: doar conținutul lui .git (obiecte, branch-uri, taguri). Nu poți edita fișiere în el, dar poți face push și clone. Așa sunt repository-urile de pe GitHub.

Ce face receive.denyCurrentBranch updateInstead?

Permite push în branch-ul deschis și actualizează și fișierele din folderul serverului, dacă acolo nu sunt modificări necomise. E folosit uneori pentru a publica un site prin push, dar pentru colaborare un repository bare e varianta sigură.

Erori înrudite

← Toate erorile Git

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Git de la zero, cu exerciții la fiecare lecție

Curs Git: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.