Docker “Cannot connect to the Docker daemon” hatası, image veya container ayarlarından önce bağlantı katmanında incelenmelidir. Kontrol sırası; önce Docker daemon’ın çalışıp çalışmadığı, ardından aktif Docker context, bağlantı socket’i veya endpoint’i ve son olarak işletim sistemi erişim izinleri şeklinde olmalıdır. Docker daemon çalışmıyorsa ya da CLI yanlış hedefe bağlanmaya çalışıyorsa image ayarlarını değiştirmek sonucu değiştirmez.
Bu nedenle ilk hedef, Docker image’ı çekmek veya docker run seçeneklerini değiştirmek değil, Docker CLI ile daemon arasında sağlıklı iletişim kurulabildiğini doğrulamaktır.
Hata hangi Docker katmanında aranmalı?
Docker’ı dört temel parçaya ayırarak düşünmek teşhisi kolaylaştırır. Docker CLI, terminalde yazdığın komutları alan istemci bileşenidir. Docker daemon veya dockerd ise image, container, ağ ve volume gibi Docker nesnelerini oluşturan ve yöneten arka plan bileşenidir. CLI, Docker API üzerinden daemon’a istek gönderir; daemon’a ulaşılamadığında komutun image ya da container aşamasına geçmesi mümkün olmaz.
Image, uygulamanın çalıştırılması için kullanılan değiştirilemez bir şablon; container ise bu image’dan oluşturulan çalışma örneğidir. Başka bir deyişle docker run komutu, önce daemon ile iletişim kurar, ardından image’ı kullanarak container oluşturur. Bağlantı kurulmadan image çekmeye çalışmak, port veya volume seçeneklerini değiştirmek, container ayarlarını düzenlemek ya da aynı komutu tekrar tekrar çalıştırmak bu katmandaki hatayı çözmez.
İlk aşamada şu soruları sırayla sor:
- Docker daemon gerçekten çalışıyor mu?
- CLI doğru Docker context’i mi kullanıyor?
- Bu context doğru socket’e veya endpoint’e mi yönleniyor?
- Kullandığın işletim sistemi hesabının ilgili bağlantı noktasına erişim izni var mı?
Context, CLI’nin hangi Docker daemon’ını hedefleyeceğini belirleyen yapılandırmadır. Yerel bir daemon yerine uzak bir endpoint seçilmişse veya ortam değişkenleri context seçimini etkiliyorsa, bilgisayarında Docker kurulu olsa bile CLI beklediğin daemon’a ulaşamayabilir. Yerel kurulumlarda kullanılan socket yolu da işletim sistemine ve çalışma biçimine göre değişebilir; bu yüzden tek bir socket yolunu her ortam için kesin çözüm kabul etmemek gerekir.
Docker image’ı çalıştırmadan önce CLI ile daemon arasındaki bağlantıyı doğrula.
docker version ve docker info çıktıları nasıl yorumlanır?
İlk teşhis için docker version ve docker info komutlarını kullanabilirsin:
docker version
docker infodocker version çıktısı normalde iki ana tarafı birlikte gösterir: Client bölümü CLI ve istemci bileşenleri hakkında, Server bölümü ise Docker Engine ve daemon tarafı hakkında bilgi verir. Çıktıdaki alt alanlar, Docker’ın nasıl kurulduğuna ve kullanılan bileşenlere göre değişebilir.
Aşağıdaki şema gerçek bir kullanıcı çıktısı değil, yorumlama modelidir:
Client: [istemci bilgileri okunuyor]
Server: [daemon bilgileri okunuyor]Client bilgileri görünürken Server veya daemon bilgileri alınamıyorsa beklenen yorum şudur: Docker CLI çalışıyor, ancak CLI ile daemon arasında bağlantı kurulamıyor. Resmî Docker CLI kayıtlarında da daemon’a erişilemeyen durumlarda Client bilgilerinin görünüp Server tarafında bağlantı hatasının raporlandığı örnekler bulunur.
docker info ise Docker kurulumuna ait sistem genelindeki bilgileri daemon’dan almaya çalışır. Başarılı bir yanıtta container ve image sayıları, çalışma ortamı, depolama sürücüsü ve benzeri daemon bilgileri görülebilir. Bu komut da bağlantı kuramıyorsa sonraki inceleme image veya container ayarlarında değil; daemon, context, socket ve işletim sistemi izinleri katmanlarında sürdürülmelidir.
Daemon, context, socket ve izinler hangi sırayla kontrol edilir?
Bu hatada önce daemon’ın çalışıp çalışmadığını, ardından aktif Docker context’ini, hedef socket yolunu ve son olarak işletim sistemi erişim izinlerini incele. Docker CLI daemon’a bağlanamıyorsa image veya container ayarlarını değiştirmek henüz çözüm değildir; önce CLI-daemon bağlantısını doğrulamalısın. Linux, macOS ve Windows için tek bir başlatma komutunu evrensel çözüm kabul etme; kurulum biçimine ve işletim sistemine uygun resmî yöntemi kullan.
- Belirti: Daemon yanıt vermiyor veya istemci yalnızca bağlantı hatası gösteriyor → Sonraki kontrol: Daemon durumunu doğrula. Önce
docker infoile Docker’dan durum bilgisi istemeyi dene. Linux’ta servis yöneticisiyle, Docker Desktop kullanılan macOS ve Windows kurulumlarında ise uygulamanın çalışır durumu ve resmî Troubleshoot/Restart akışıyla kontrol yap. Daemon durmuşsa başlatma yöntemi dağıtıma, kurulum tipine ve sürüme göre değişebilir; tek bir komutu kesin çözüm gibi uygulama. - Belirti: Daemon çalışıyor görünüyor fakat hata sürüyor → Sonraki kontrol: Aktif context’i ve endpoint’i incele.
docker context lsile mevcut context’leri, yıldız işaretiyle belirtilen aktif seçimi ve listelenen Docker endpoint’ini gör. Ardındandocker context showile etkin context adını, gerekirsedocker context inspect <context-adı>ile ayrıntılı hedefi kontrol et. CLI yanlış veya artık erişilemeyen uzak daemon’a yöneliyor olabilir. - Belirti: Hata metninde
unix:///var/run/docker.sockgibi bir yol var → Sonraki kontrol: Socket hedefini tüm ayarlarla karşılaştır. Hata mesajındaki socket ya da endpoint’i, context çıktısındakiDOCKER ENDPOINTve ayrıntılıHostdeğeriyle karşılaştır. Ayrıca mevcut kabuktaDOCKER_HOSTtanımlı mı bak; bu değişken Docker CLI’yi farklı bir daemon’a yönlendirebilir.DOCKER_CONTEXTgibi başka bir seçim de aktif hedefi etkileyebileceğinden yalnızcadocker context usesonucuna güvenme. - Belirti: Endpoint doğru, ancak erişim reddediliyor → Sonraki kontrol: İşletim sistemi izinlerini incele. Linux’ta socket’in sahibi, grubu ve mevcut kullanıcının ilgili gruba erişimi kontrol edilir. Docker grubunun daemon üzerinde yüksek yetkiler sağlayabildiğini unutma; rastgele izin genişletmek yerine kurulumun önerdiği kullanıcı ve grup yapılandırmasını takip et. Windows ve macOS’ta erişim, Docker Desktop’ın backend ve socket yapılandırmasına bağlı olabilir.
- Belirti: Düzeltme yapıldı → Sonraki kontrol: Basit bir istemci komutuyla yeniden dene.
docker psçalışıyor ve hata vermiyorsa bağlantı katmanı büyük ölçüde düzelmiştir. Çalışan container bulunmaması, bağlantının başarısız olduğu anlamına gelmez; sonuç boş bir liste de olabilir.
Docker bağlantı hatası için kısa karar ağacı
docker version veya docker info daemon verisi döndürüyor mu?
- Hayır: Önce daemon durumunu kontrol et.
- Daemon çalışıyor görünüyor: Aktif context ile hedef endpoint’i karşılaştır.
- Endpoint doğru, erişim reddediliyor: Socket yolunu ve işletim sistemi izinlerini incele.
- Daemon verisi geliyor, ancak
docker runsonrasında hata oluşuyor: CLI-daemon bağlantısı geçilmiştir; artık image, container veya çalıştırma seçenekleri katmanını araştır.
Bu ayrım, “sorun hangi katmanda?” sorusunu hızlıca yanıtlar: daemon verisi alınamıyorsa bağlantı katmanında, alınabiliyorsa sonraki Docker nesnesi katmanında teşhis yapmalısın.
Üç yaygın senaryoda belirti ve sonraki teşhis adımı
Aynı bağlantı sorunu üç farklı noktadan kaynaklanabilir: daemon çalışmıyor veya erişilemiyor olabilir, Docker CLI yanlış bir context üzerinden bağlantı kurmaya çalışabilir ya da daemon çalıştığı hâlde socket ve işletim sistemi izinleri yetersiz kalabilir. Belirtiler; işletim sistemine, Docker Engine veya Docker Desktop kurulumuna ve kullanılan sürüme göre değişebileceği için kesin bir hata metnine değil, bağlantının hangi katmanda koptuğuna odaklanmalısın. Docker belgeleri de daemon durumunun docker info ile, hedef endpoint’in context üzerinden ve socket erişiminin kullanıcı izinleriyle incelenmesini önerir.
| Senaryo | Beklenen belirti | Bir sonraki teşhis adımı |
|---|---|---|
| Daemon kapalı veya erişilemiyor | Docker CLI kendi tarafındaki bilgileri gösterebilse bile daemon’dan veri alamaz. Yerel Docker servisi durmuş olabilir veya CLI erişilemeyen başka bir hedefe yönlenmiş olabilir. | Daemon’ın çalışıp çalışmadığını işletim sistemine ve kurulum biçimine uygun yöntemle doğrula. Docker Desktop kullanıyorsan uygulamanın durumunu, servis tabanlı bir kurulumda ise işletim sisteminin servis araçlarını ve gerekirse daemon günlüklerini incele. |
| Yanlış Docker context seçili | Komutlar beklenen yerel Engine yerine başka bir yerel veya uzak daemon’a bağlanmaya çalışır. Aktif context işareti ya da görünen endpoint, çalışmak istediğin hedefle uyuşmayabilir. | docker context ls ile aktif context’i kontrol et; ardından docker context inspect çıktısındaki endpoint’i beklediğin hedefle karşılaştır. Ortam değişkenleri veya komut satırı seçeneklerinin context’i geçersiz kılıp kılmadığını da incele. |
| Daemon çalıştığı hâlde socket ya da işletim sistemi yetkisi yetersiz | Daemon servisinin çalıştığı görülür; ancak mevcut kullanıcı Docker CLI üzerinden daemon’a erişemez. Unix socket kullanan kurulumlarda socket’in sahibi, grubu ve kullanıcı oturumunun grup yetkileri belirleyici olabilir. | Aktif context’in gösterdiği socket veya endpoint yolunu, socket erişim izinlerini ve kullanıcının grup üyeliklerini incele. Linux gibi Unix socket kullanan sistemlerde yetkili bir kullanıcıyla yapılan karşılaştırmalı test, sorunun daemon’dan çok erişim yetkisinde olup olmadığını anlamaya yardımcı olabilir. |
Bağlantı düzeldikten sonra image ve container katmanına geçiş
docker info daemon verilerini döndürüyor ve docker ps gibi basit bir Docker CLI komutu çalışıyorsa bağlantı katmanını geçmiş sayılabilirsin. Bundan sonra docker run sırasında görülen sorunlar farklı bir katmana aittir: image bulunamaması, image etiketinin yanlış olması, container parametrelerinin uyumsuzluğu veya uygulama ayarları gibi nedenler ayrı ayrı incelenmelidir. Docker’ın çalışma mantığında docker run, bir image’dan yeni bir container oluşturur ve ihtiyaç varsa image’ı çekmeye çalışır; dolayısıyla bu aşamadaki hata, bağlantı sorunundan sonra kendi mesajına göre değerlendirilmelidir.
Bu yazının sınırını şu kısa kontrolle koru:
- Daemon erişilebilir mi?
- Doğru context mi seçili?
- Doğru endpoint mi kullanılıyor?
- Mevcut kullanıcının gerekli izni var mı?
- Ancak bundan sonra image ve container ayarlarına geçiliyor mu?
Bu akış, temel Docker CLI bağlantı teşhisine odaklanır; Compose’a özgü bağlantı sorunları bu kapsamın dışındadır.
Sık Sorulan Sorular
docker version ile docker info arasındaki fark nasıl anlaşılır?
docker version, öncelikle Docker CLI ve Docker Engine gibi istemci-sunucu bileşenlerinin sürüm bilgilerini gösterir. docker info ise daemon’ın sistem genelindeki durumuna ilişkin bilgileri; örneğin image, container ve depolama verilerini sunar. Kısaca, docker version istemci ile sunucunun iletişim görünümünü, docker info ise daemon’ın cevap verip vermediğini ve çalışma ortamını incelemek için kullanılır.
Docker context yanlış seçildiğinde hangi kontrol yapılmalıdır?
Önce docker context ls çıktısında aktif context’i ve endpoint’i kontrol etmelisin. Hedef ayrıntısını görmek için docker context inspect kullanılabilir. Liste doğru görünse bile DOCKER_HOST, DOCKER_CONTEXT veya komut satırındaki ilgili seçeneklerin bağlantı hedefini değiştirebileceğini unutma.
Daemon çalışıyor görünürken docker.sock izin sorunu nasıl ayırt edilir?
Unix socket kullanan kurulumlarda daemon çalışırken normal kullanıcıyla yapılan Docker sorgusu başarısız, yetkili kullanıcıyla yapılan kontrollü karşılaştırma başarılı oluyorsa socket veya kullanıcı yetkileri şüphelenilecek ilk noktadır. Socket’in sahiplik ve grup bilgilerini, mevcut kullanıcının grup üyeliklerini ve oturumun bu değişiklikleri tanıyıp tanımadığını incele. Docker grubunun erişim sağlarken yüksek yetkiler verebileceğini de dikkate al; geçici olarak yetkili komut kullanmak kalıcı izin çözümü anlamına gelmez.
Bağlantıyı daemon’dan başlayarak context, endpoint ve izin sırasıyla doğruladığında image ve container katmanına daha temiz bir teşhisle geçebilirsin.
