Git push “The current branch main has no upstream branch” hatası, yerel main dalının uzak depodaki hangi dala gönderileceği ve hangi uzak dalı takip edeceği henüz tanımlanmadığında görülür. Git, bu eşleştirmeyi ilk gönderim sırasında oluşturmanı ister; çoğu durumda çözüm, önerilen git push -u origin main komutunu çalıştırmaktır.
Buradaki dal, projenin ayrı bir geliştirme çizgisidir. Uzak depo, GitHub üzerindeki proje deposunu; origin ise bu uzak depoya verilen kısa adı ifade eder. main yerel dalın adıdır, upstream ise bu dalın uzak depoda takip edeceği karşılığıdır.
Git bu upstream hatasını neden gösterir?

Git, yerel main dalının uzak depodaki hangi dala gönderileceğini bilmediği için bu hatayı gösterir. Yerel dal ile uzak dalın adları aynı olsa bile Git, bu ilişkinin otomatik olarak tanımlandığını varsaymayabilir.
fatal: The current branch main has no upstream branch.
To push the current branch and set the remote as upstream, use
git push --set-upstream origin main
Önerilen komutu parçalara ayırırsak origin, uzak deponun takma adıdır. İlk main ise yerel dalı belirtir ve aynı ad, komutun bu dalı uzak depodaki main dalına göndermesini sağlar. --set-upstream seçeneği de gönderimden sonra bu uzak dalı yerel dalın takip ettiği upstream olarak kaydeder.
Git’in gösterdiği ek öneri satırları kullandığın sürüme ve yapılandırmaya göre değişebilir. Bazı çıktılarda, yeni dallar için upstream ayarını otomatikleştirebilen push.autoSetupRemote yapılandırmasından da söz edilir. Komutun temel amacı ise aynıdır: yerel dalı uzak depodaki hedef dal ile eşleştirmek.
Upstream nedir ve git push -u neyi ayarlar?
Upstream, yerel bir dal ile uzak depodaki takip edilen dal arasındaki eşleştirmedir. Git bu bilgiyi bildiğinde, yerel main dalının karşılığının origin/main olduğunu anlayabilir. Git push belgelerinde belirtildiği gibi -u seçeneği, --set-upstream seçeneğinin kısa biçimidir.
GitHub’da boş bir depo oluşturduğunu ve yerel projeyi Git ile başlattığını düşünelim. Önce bir dosya oluşturup commit atabilir, ardından GitHub deposunu origin adıyla ekleyebilirsin:
git init
git branch -M main
printf "# Deneme Projesin" > README.md
git add README.md
git commit -m "İlk commit"
git remote add origin https://github.com/kullanici/proje.git
git push
Bu noktadaki git push komutu, yerel main dalı için upstream tanımlanmadığından hata verebilir. İlk gönderimi hedefi açıkça belirterek yapmak için şu komutlardan birini kullanabilirsin:
git push -u origin main
git push --set-upstream origin main
İki komut da yerel main dalını origin/main ile eşleştirir ve commitlerini uzak depoya gönderir. Ayarın oluşup oluşmadığını görmek için şu komutu çalıştırabilirsin:
git branch -vv
Çıktıda main satırının yanında [origin/main] ifadesini görmen, yerel dalın upstream bilgisinin kaydedildiğini gösterir. Aynı işlem farklı bir dal için de geçerlidir. Örneğin feature/giris dalını ilk kez gönderirken hedefi ve upstream bilgisini birlikte tanımlayabilirsin:
git switch -c feature/giris
git push -u origin feature/giris
Upstream ayarı sonrası neden yalnızca git push yeterlidir?

Yerel main dalının varsayılan gönderim hedefi origin/main olarak kaydedildiğinde Git, sonraki gönderimlerde hangi uzak depoya ve hangi dala yazacağını bilir. Bu nedenle aynı dalda yeni bir commit oluşturduktan sonra yalnızca git push komutunu çalıştırman yeterlidir.
Bu ilişkiyi kontrol etmek için git branch -vv komutunu kullanabilirsin. -vv seçeneği yerel dalları, kısa commit bilgisini ve varsa takip edilen upstream dalını gösterir. Git’in resmî dal belgelerinde bu görünümün upstream ve dal ilişkisini izlemek için kullanıldığı açıklanır.
$ git branch -vv
* main 1a2b3c4 [origin/main] İlk commit
Buradaki yıldız, üzerinde çalıştığın dalın main olduğunu gösterir. [origin/main] ifadesi ise yerel main dalının uzak depodaki main dalını takip ettiğini anlatır. Uzak depoda senden sonra yeni commit varsa ya da yerelde henüz gönderilmemiş commit bulunuyorsa, bu bölümde ileride ve geride olma bilgileri de görülebilir.
Her yeni dalın takip ilişkisi ayrıca kurulmalıdır. Örneğin main dalından giriş ekranı için yeni bir dal oluşturduğunu düşünelim:
$ git switch -c feature/giris
$ git push
İlk git push komutu burada yine upstream hatası verebilir. Çünkü feature/giris, main dalından oluşturulmuş yeni bir yerel daldır ve henüz uzak depodaki hangi dalı takip edeceği belirtilmemiştir. Eşleştirmeyi şu komutla kurarsın:
$ git push -u origin feature/giris
Bu komut, yerel feature/giris dalını uzak depodaki aynı adlı dala gönderir ve aralarında upstream ilişkisi kurar. Bundan sonraki değişikliklerde, feature/giris dalındayken git push komutu yeterli olur. main ve feature/giris birbirinden ayrı dallar olduğu için her birinin kendi takip bilgisi bulunur.
Dal adı ve uzak depo kaynaklı sorunlar nasıl ayırt edilir?
Dal adı ve uzak depo sorunlarını ayırt etmek için önce hangi dalda olduğunu, ardından uzak deponun hangi adla kayıtlı olduğunu kontrol etmelisin. Aktif dalı görmek için şu komutu çalıştır:
$ git branch --show-current
main
Çıktı main yerine master ise push komutunda da doğru adı kullanmalısın. Örneğin aktif dalın master ise git push -u origin master komutunu çalıştırman gerekir. main ve master adlarını birbirinin yerine yazmak, Git’in farklı bir yerel dal aramasına yol açabilir.
Uzak depo bağlantısını kontrol etmek için git remote -v komutunu kullanabilirsin:
$ git remote -v
origin https://github.com/kullanici/proje.git (fetch)
origin https://github.com/kullanici/proje.git (push)
Bu çıktıda origin, uzak depo adresinin kısa adıdır. Git’in resmî remote belgelerine göre -v seçeneği kayıtlı uzak deponun adreslerini gösterir. Komut hiçbir satır döndürmüyorsa proje henüz bir uzak depoya bağlanmamış olabilir; uzak depo eklenmeden push denememelisin.
Uzak depo adı origin olmak zorunda değildir. Bağlantı github, upstream veya başka bir adla kaydedildiyse komutta o adı kullanmalısın:
$ git push -u github main
failed to push some refs mesajı, bu yazıdaki upstream bilgisinin eksik olduğunu belirten hatayla aynı değildir. Bu mesaj görüldüğünde uzak depo ile yerel geçmiş arasındaki başka bir durum ayrıca incelenmelidir.
Sık Sorulan Sorular
git push -u origin main komutu tam olarak ne yapar?
git push -u origin main yerel main dalını origin adlı uzak depoya gönderir ve yerel main dalının takip edeceği uzak dalı kaydeder.
main ve master dallarından hangisini git push komutunda kullanmalıyım?
git push komutunda, üzerinde çalıştığın yerel dalın adını kullanmalısın. Bu adı git branch --show-current komutuyla kontrol edebilirsin.
Her yeni dalda neden yeniden upstream ayarı yapmak gerekir?
Her yeni dal, hangi uzak dalı takip edeceği başlangıçta belirtilmemiş ayrı bir yerel daldır. Bu nedenle ilk gönderimde git push -u origin dal-adı komutuyla kendi takip ilişkisini kurması gerekir.
git branch -vv komutuyla hangi bilgileri kontrol edebilirim?
git branch -vv ile yerel dalları, aktif dalı, kısa commit bilgisini, takip edilen upstream dalını ve yerel dalın uzak dala göre ileride ya da geride olup olmadığını kontrol edebilirsin.
Upstream ilişkisini dal bazında kurduğunda Git, sonraki gönderimlerde hedefi yeniden yazmanı beklemez. Yeni bir dal oluşturduğunda ise aynı kontrolü ve ilk eşleştirmeyi o dal için ayrıca yapman gerekir.