Container teknolojileri etiketine sahip kayıtlar gösteriliyor. Tüm kayıtları göster
Container teknolojileri etiketine sahip kayıtlar gösteriliyor. Tüm kayıtları göster

3 Şubat 2026 Salı

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.