Windows 11’de WSL2 ile Docker Desktop Kurulumu ve Performans Ayarları (Adım Adım Rehber)

WSL2 + Docker: Neden Bu Kurulum?

Windows 11 üzerinde Linux tabanlı geliştirme yapmak artık “ikinci bir bilgisayar” ihtiyacı olmadan oldukça konforlu. WSL2 (Windows Subsystem for Linux 2), gerçek bir Linux çekirdeğiyle çalıştığı için dosya sistemi, ağ ve container uyumluluğu açısından WSL1’e göre belirgin avantajlar sunuyor. Buna Docker Desktop eklendiğinde; Kubernetes denemeleri, mikroservis geliştirme, CI ortamına yakın bir test akışı ve Linux image’larıyla sorunsuz çalışma gibi artılar elde ediyorsunuz.

Bu yazıda, Windows 11’de WSL2 kurulumundan başlayarak Docker Desktop’ı WSL2 tabanlı şekilde yapılandırmayı, ardından da performansı etkileyen kritik ayarları adım adım ele alacağız. Hedefimiz; stabil, hızlı ve günlük kullanımda sorun çıkarmayan bir geliştirme ortamı kurmak.

1) Ön Koşullar ve Kontroller

Kuruluma başlamadan önce sisteminizin bazı gereksinimleri karşıladığından emin olun. Windows 11’in güncel bir sürümünü kullanmanız önerilir. Ayrıca BIOS/UEFI tarafında sanallaştırma açık olmalıdır. Intel tarafında genellikle VT-x, AMD tarafında SVM olarak geçer.

Windows üzerinde WSL durumunu kontrol etmek için PowerShell’i yönetici olarak açıp şu komutu kullanabilirsiniz: wsl --status. Eğer WSL kurulu değilse veya sürüm eskiyse birazdan bunu da kuracağız.

2) WSL2 Kurulumu ve Linux Dağıtımı Seçimi

Windows 11’de WSL kurulumu çoğu sistemde tek komutla yapılabiliyor. PowerShell (Yönetici) üzerinde şu komutu çalıştırın: wsl --install. Bu komut varsayılan olarak uygun bileşenleri yükler ve genellikle Ubuntu kurulumunu başlatır. İşlem bittiğinde yeniden başlatma isteyebilir.

Dağıtımı elle seçmek isterseniz: wsl --list --online ile mevcut dağıtımları listeleyebilir, ardından wsl --install -d Ubuntu gibi bir komutla belirli bir dağıtımı kurabilirsiniz. Geliştirme amaçlı en yaygın tercih Ubuntu’dur; paket ekosistemi geniş, dokümantasyonu güçlüdür.

Kurulumdan sonra WSL’nin varsayılan sürümünü WSL2 yapmak için şu komut işe yarar: wsl --set-default-version 2. Mevcut bir dağıtımı WSL2’ye geçirmek gerekirse: wsl --set-version Ubuntu 2.

3) Docker Desktop Kurulumu (WSL2 Backend ile)

Docker Desktop, Windows üzerinde Docker Engine’i çalıştırmanın en pratik yoludur. Resmî Docker Desktop kurulum dosyasını indirip kurulum adımlarını izleyin. Kurulum sırasında “WSL 2 based engine” seçeneğinin etkin olduğundan emin olun. Bu seçenek, Hyper-V tabanlı klasik yaklaşım yerine WSL2 altyapısını kullanarak daha akıcı bir deneyim sunar.

Kurulum sonrası Docker Desktop’ı açın ve Settings bölümünde WSL entegrasyonunu kontrol edin. Genellikle Resources > WSL Integration altında, kurduğunuz Linux dağıtımı için entegrasyonu etkinleştirmeniz gerekir. Örneğin Ubuntu için anahtarı açtığınızda, Docker komutlarını doğrudan WSL terminalinden kullanabilirsiniz.

4) WSL İçinde Docker Komutlarını Test Etme

Ubuntu terminalini açıp şu komutlarla test yapın: docker version ve docker ps. Eğer Docker Desktop çalışıyorsa sürüm bilgisi gelmeli ve çalışan container listesi (boş da olabilir) görüntülenmelidir. Ardından hızlı bir test için: docker run --rm hello-world komutunu çalıştırabilirsiniz. Bu image başarıyla indiriliyor ve çalışıyorsa kurulum tamamdır.

5) Performans İçin Kritik Ayarlar (Gerçek Hayat İpuçları)

Dosyaları doğru yerde tutun: En sık yapılan hata, proje dosyalarını Windows dosya sistemi üzerinde (ör. C:\Users\...) tutup WSL üzerinden işlemektir. Bu yaklaşım bazı senaryolarda yavaşlar. Daha iyi performans için projelerinizi WSL dosya sisteminde, örneğin /home/kullanici/proje altında konumlandırın. Editör olarak VS Code kullanıyorsanız “Remote - WSL” eklentisiyle WSL içindeki projeye sorunsuz bağlanabilirsiniz.

Kaynak limitlerini yönetin: WSL2, varsayılan olarak sistem kaynaklarını dinamik kullanır. Ancak büyük projelerde veya çok sayıda container çalıştırırken RAM/CPU kullanımını kontrol etmek isteyebilirsiniz. Windows kullanıcı dizininizde .wslconfig dosyası oluşturarak örneğin bellek ve işlemci sınırı koyabilirsiniz. Bu sayede sisteminizin tamamının WSL2 tarafından “yutulmasını” engellersiniz.

Docker Desktop kaynak ayarları: Docker Desktop içinde CPU/RAM limitlerini düzenlemek, özellikle laptop kullanıcılarında fan ve pil yönetimi açısından önemlidir. Ayrıca disk imajının bulunduğu sürücüde yeterli boş alan olduğundan emin olun. Container’lar ve image’lar zamanla şişebilir; kullanılmayanları temizlemek için düzenli aralıklarla docker system prune komutunu dikkatli şekilde kullanabilirsiniz.

6) Sık Karşılaşılan Sorunlar ve Çözümler

Docker komutu bulunamadı: WSL entegrasyonunu Docker Desktop ayarlarından etkinleştirdiğinizden emin olun. Ayrıca Docker Desktop’ın çalışır durumda olması gerekir.

WSL güncelleme ihtiyacı: Bazı durumlarda çekirdek güncellemesi gerekebilir. PowerShell’de wsl --update komutunu çalıştırarak WSL bileşenlerini güncelleyebilirsiniz.

Ağ/port erişimi: Container içinde çalışan servisleri Windows üzerinden görmek için port yönlendirmesinin doğru olduğundan emin olun (ör. -p 3000:3000). Güvenlik yazılımları veya kurumsal politikalar bazı portları kısıtlayabilir.

Sonuç

WSL2 ile Docker Desktop birleşimi, Windows 11 üzerinde Linux-native geliştirme deneyimini ciddi şekilde iyileştiriyor. Doğru dağıtımı seçip WSL entegrasyonunu etkinleştirdikten sonra, projelerinizi WSL dosya sistemi içinde tutarak ve kaynak limitlerini bilinçli ayarlayarak hem stabil hem de hızlı bir ortam kurabilirsiniz. Bu rehberdeki adımlar tamamlandığında; Node.js, Python, Go, .NET ve daha pek çok teknoloji için container tabanlı geliştirme akışına hazır olacaksınız.

Windows 11’de WSL2 ile Docker Desktop Kurulumu: Yerel Kubernetes ve Hızlı Geliştirme Ortamı

WSL2 + Docker ile neden uğraşalım?

Windows 11 kullanırken Linux tabanlı geliştirme araçlarını “gerçek” bir Linux deneyimine yakın şekilde çalıştırmanın en pratik yolu WSL2’dir. WSL2 üzerine Docker kurduğunuzda, hem container’larınızı yerel olarak hızlıca ayağa kaldırabilir hem de isterseniz Docker Desktop’ın sağladığı entegre Kubernetes’i kullanarak mikro servis denemeleri yapabilirsiniz. Bu yazıda hedefimiz; Windows 11’de WSL2’yi etkinleştirmek, uygun bir Linux dağıtımı kurmak, Docker Desktop’ı WSL2 altyapısıyla çalıştırmak ve yaygın hatalara karşı kontrol listesi oluşturmak.

Ön koşullar

Gerekenler: Windows 11 (güncel), yönetici yetkisi, BIOS/UEFI’de sanallaştırmanın açık olması (Intel VT-x/AMD-V), en az 8 GB RAM (Kubernetes açacaksanız 16 GB daha rahat). Ayrıca kurulum sırasında internet bağlantısı şart.

1) WSL2’yi etkinleştirin

Önce Windows özellikleri tarafında WSL2 altyapısını açacağız. En hızlı yöntem PowerShell’i yönetici olarak çalıştırıp aşağıdaki komutu kullanmaktır:

PowerShell (Yönetici): wsl --install

Bu komut gerekli bileşenleri kurar ve varsayılan bir Linux dağıtımı yükler. Kurulum bitince bilgisayarı yeniden başlatmanız istenebilir. Halihazırda WSL yüklüyse sürümü doğrulamak için şu komutu çalıştırın:

PowerShell: wsl -l -v

Çıktıda dağıtımınızın VERSION sütununda 2 görünmesi gerekir. Eğer 1 ise, WSL2’ye çevirmek için:

PowerShell: wsl --set-version Ubuntu 2

2) Ubuntu’yu güncelleyin ve temel araçları kurun

Ubuntu terminalini açın (Başlat menüsünden “Ubuntu”). İlk iş paketleri güncellemek iyi bir alışkanlıktır:

Ubuntu: sudo apt update && sudo apt -y upgrade

Git ve bazı yardımcı paketler de işinizi kolaylaştırır:

Ubuntu: sudo apt -y install git ca-certificates curl

3) Docker Desktop’ı kurun ve WSL2 entegrasyonunu açın

Docker’ı Windows tarafında Docker Desktop ile yönetmek, ağ, proxy, GUI ayarları ve Kubernetes gibi özellikleri tek yerden kontrol etmenizi sağlar. Resmi kurulum dosyasını Docker’ın web sitesinden indirip standart şekilde kurabilirsiniz. Kurulum sırasında veya sonrasında Docker Desktop içinde şu ayarları kontrol edin:

Ayarlar > General: “Use the WSL 2 based engine” seçeneği açık olmalı.

Ayarlar > Resources > WSL Integration: “Enable integration with my default WSL distro” açık olmalı ve Ubuntu dağıtımınız seçili olmalı.

Bu noktadan sonra Ubuntu terminalinde Docker komutlarının çalıştığını test edin:

Ubuntu: docker version

Eğer sürüm bilgisi geliyorsa bağlantı tamamdır. Basit bir test container’ı çalıştırabilirsiniz:

Ubuntu: docker run --rm hello-world

4) Yerel Kubernetes’i etkinleştirme (isteğe bağlı)

Mikro servis mimarisiyle uğraşıyorsanız, yerel Kubernetes büyük kolaylık. Docker Desktop içinde:

Ayarlar > Kubernetes: “Enable Kubernetes” seçeneğini açın ve kurulumu bekleyin. İlk kurulum birkaç dakika sürebilir.

Kurulum tamamlanınca kubectl komutunu doğrulayın. Docker Desktop genellikle kubectl’i beraberinde getirir. Ubuntu içinde:

Ubuntu: kubectl version --client

Ardından cluster durumuna bakın:

Ubuntu: kubectl get nodes

Tek node “Ready” görünüyorsa, yerel Kubernetes ortamınız hazırdır.

5) Performans için kritik ipuçları

WSL2 üzerinde Docker kullanırken en sık yapılan hata, proje dosyalarını Windows dosya sistemi altında (ör. /mnt/c/...) tutmaktır. Bu, özellikle Node.js, Python veya büyük bağımlılık ağaçlarında ciddi yavaşlamaya neden olur. En iyi pratik, projeleri Linux dosya sistemi içinde (ör. ~/projects) saklamaktır.

Ayrıca Docker Desktop’ta Resources bölümünden CPU/RAM sınırlarını iş yükünüze göre ayarlayın. Kubernetes açıkken RAM tüketimi artar; 8 GB sistemlerde aynı anda çok container çalıştırmak zorlaşabilir.

6) Yaygın sorunlar ve hızlı çözüm listesi

“WSL 2 installation is incomplete”: Windows Update’i çalıştırın, ardından “wsl --update” komutunu deneyin.

Docker çalışıyor ama Ubuntu’da “Cannot connect to the Docker daemon”: Docker Desktop’ta WSL Integration açık mı kontrol edin. Ubuntu’yu kapatıp yeniden açın; gerekirse “wsl --shutdown” ile WSL’yi yeniden başlatın.

Kubernetes pod’ları sürekli Pending: Sistem kaynakları yetersiz olabilir. Docker Desktop kaynak limitlerini yükseltin veya Kubernetes’i kapatın.

Disk şişmesi: Kullanılmayan imaj ve volume’ları düzenli temizleyin: “docker system prune” (dikkatli kullanın) ve büyük volume’ları gözden geçirin.

Sonuç

Windows 11’de WSL2 ile Docker Desktop kurduğunuzda, hem Linux uyumlu geliştirme akışını yakalarsınız hem de container tabanlı projeleri hızlıca test edebilirsiniz. Üstelik tek tıkla Kubernetes açıp kapatabilmek, yerel ortamda prod’a benzer senaryoları denemenin en pratik yollarından biridir. Dosyaları Linux tarafında tutmak ve kaynak ayarlarını doğru yapmak, bu kurulumdan maksimum verimi almanızı sağlar.