Docker’ı kullanmaya başlamadan önce elbette kurmanız gerekir. Kurulum, işletim sisteminize göre birkaç dakika süren basit bir işlemdir — bu yazıda Windows, macOS ve Linux için en güncel ve önerilen kurulum yollarını adım adım görüyoruz.

Windows ve macOS: Docker Desktop

Masaüstü işletim sistemlerinde en pratik yol Docker Desktop‘tır — hem Docker Engine’i hem de grafik arayüzü, Docker Compose’u ve Kubernetes’i tek pakette bir araya getirir.

  1. docker.com/products/docker-desktop adresinden işletim sisteminize uygun kurulum dosyasını indirin.
  2. Windows’ta kurulum sihirbazı, WSL 2 (Windows Subsystem for Linux) motorunu otomatik olarak etkinleştirmenizi ister — bu adımı onaylayın, Docker Windows’ta bu motoru kullanarak çalışır.
  3. Kurulum bittikten sonra Docker Desktop’ı başlatın; görev çubuğundaki balina ikonu “Docker Desktop is running” yazısını gösterdiğinde hazırsınız demektir.

Kurulumu doğrulamak

İşletim sisteminiz fark etmeksizin, bir terminal (Windows’ta PowerShell, macOS’ta Terminal) açıp şu iki komutu çalıştırın:

docker --version
docker run --rm hello-world

İlk komut kurulu Docker sürümünü gösterir; ikinci komut küçük bir test imajını indirip çalıştırır ve başarılıysa size Docker’ın doğru kurulduğunu anlatan bir karşılama mesajı basar.

Linux: Docker Engine doğrudan sistemde

Linux’ta Docker Desktop’a ihtiyacınız yoktur — Docker Engine doğrudan işletim sisteminize kurulabilir. Ubuntu/Debian tabanlı bir dağıtımda resmi kurulum betiği en hızlı yoldur:

# Resmi kurulum betiğini indirip çalıştırın
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

# Docker servisinin çalıştığını doğrulayın
sudo systemctl status docker
i

Kurulumdan hemen sonra Linux’ta docker komutlarını her seferinde sudo ile çalıştırmanız gerekir, çünkü Docker daemon’ı varsayılan olarak root yetkisiyle çalışır ve soket dosyasına sadece root erişebilir. Bunu ortadan kaldırmak için:

# Kendi kullanıcınızı 'docker' grubuna ekleyin
sudo usermod -aG docker $USER

# Değişikliğin etkili olması için oturumu kapatıp
# tekrar açın (veya: newgrp docker)
docker run --rm hello-world   # artık sudo'suz çalışmalı

Docker Compose kurulu mu?

Güncel Docker sürümlerinde Docker Compose artık ayrı bir program değil, docker komutunun bir alt komutudur (eski docker-compose yerine docker compose, aralarında boşlukla):

docker compose version

Bu komut bir sürüm numarası döndürmüyorsa, dağıtımınıza göre docker-compose-plugin paketini ayrıca kurmanız gerekebilir.

Hızlı sorun giderme

  • “Cannot connect to the Docker daemon” hatası: Docker Desktop’ın (Windows/macOS) açık olduğundan veya Linux’ta sudo systemctl start docker ile servisin başlatıldığından emin olun.
  • WSL 2 hataları (Windows): PowerShell’i yönetici olarak açıp wsl --update komutuyla WSL çekirdeğini güncelleyin, ardından bilgisayarı yeniden başlatın.
  • Apple Silicon (M1/M2/M3) Mac’lerde bazı imajlar çalışmıyor: Bu imajlar muhtemelen sadece x86_64 mimarisi için build edilmiştir; ARM uyumlu bir etiket arayın veya --platform linux/amd64 bayrağıyla emülasyon modunda çalıştırın (daha yavaş olur).

Docker kurulu ve çalışır durumda olduğuna göre, artık ilk container’ınızı çalıştırmaya ve temel komutları öğrenmeye hazırsınız — sıradaki yazıda günlük kullanımda en çok ihtiyaç duyacağınız docker komutlarını bir arada topluyoruz.