WSL 2 Kurulumu - 6 kolay adım

WSL (The Windows Subsystem for Linux) Windows'u bırakmadan, sisteme ekstra yük bindirecek sanal makine çözümlerine başvurmadan hızlı ve basit şekilde GNU/Linux ortamı kurmak ve bunun üzerinde geliştirme yapmak isteyenler için ideal bir çözüm.

💡 Özet (TL;DR):

• Modern Yöntem (Windows 11 ve Güncel Windows 10): Yönetici olarak PowerShell açıp wsl --install çalıştırın ve bilgisayarınızı yeniden başlatın. Bu komut tüm gereksinimleri otomatik kurar.
• Eski Sürümler / Manuel Yöntem: Eğer otomatik kurulum çalışmazsa, aşağıdaki 6 adımı sırasıyla takip ederek sanallaştırma platformunu etkinleştirebilir ve manuel kurulum yapabilirsiniz.

WSL Kurulum Adımları

Adım 1 - Linux için Windows Alt Sistemini Etkinleştirme

Windows'unuza herhangi bir Linux sürümü yüklemeden önce Linux için Windows Alt Sistemi'ni ( İngilizce Windows kullanıyorsanız Windows Subsystem for Linux ) etkinleştirmelisiniz. Bunu Denetim Masası > Programlar ve Özellikler > Windows Özelliklerini Aç veya Kapat ekranından ilgili kutucuğu işaretleyerek yapabileceğiniz gibi bir yönetici yetkileri ile bir PowerShell açıp aşağıdaki komutu da çalıştırabilirsiniz:

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

Bu işlemden sonra doğrudan 6. adımdaki Linux kurulumuna geçmeniz mümkün ama bu durumda WSL 1 ile devam etmiş olursunuz, WSL ile 2 ile devam etmeniz tam bir Linux çekirdeği kullanmanız ve daha yüksek performans elde etmenizi sağlayacaktır. Bu nedenle öncesinde bir kaç adım daha takip edip WSL 2 ile devam etmenizi öneririm.

Adım 2 - WSL 2 sistem gereksinimlerini kontrol etme

Öncellikle WSL 2 güncellemesi için Windows 10 kullanıyor olmalısınız.

• x64 tabanlı sistemleri: Sürüm 1903 veya daha üstü, Yapım numarası 18362 veya daha üstü olması gerekiyor.
• ARM 64 tabanlı sistemler: Sürüm 2004 veya daha üstü, Yapım numarası 19041 veya daha üstü olması gerekiyor
• 18362'den daha düşük yapımlar WSL 2 desteklemiyorlar, öncellikle Windows sürümünüzü yükseltmelisiniz.

Sürüm ve yapım numaranızı kontrol etmek için Windows Logo tuşu + R tuş kombinasyonuna basmalı (Başlangıçtan çalıştır'a gelmeli) ve winver yazarak çalıştırmalısınız.

Adım 3 - Sanal makine özelliğini etkinleştirme

WSL 2'yi kurmadan önce Sanal Makine Platformu özelliğini etkinleştirmelisiniz. Bu özelliği kullanmak için makinenizin sanallaştırma yapabiliyor olması gerekir (bu konuda sorun yaşarsanız muhtemelen Bios'dan etkinleştirmeniz gerekiyordur)

Etkinleştirme için PowerShell'i yönetici yetkileri ile açın ve aşağıdaki komutu çalıştırın

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Wsl kurumunu ve Wsl 2'ye yükseltilmesini tamamlamak için makinenizi yeniden başlatmanız gerekir.

Adım 4 - Linux çekirdeği güncelleme paketini indirin

1. Son paket sürümünü aşağıdaki bağlantıdan indirin
   • X64 tabanlı sistemler için WSL2 Linux çekirdeği paketi
   • ARM64 tabanlı sistemler için WSL2 Linux çekirdeği paketi
2. İndirme tamamlandıktan sonra çift tıklayarak paketi çalıştırın, yönetici yetkileri istendiğinde izin verin ve kuruluma devam edin.

Kurulum tamamlandığında sonraki adıma - yeni kurulacak linux sürümleri için varsayılan olarak WSL 2 ayarlama- geçebilirsiniz.

Adım 5 - WSL2'yi varsayılan WSL sürümü olarak ayarlayın

Yeni kurulacak Linux sürümlerinde varsayılan olarak WSL2 kullanılması için PowerShell'de aşağıdaki komutu çalıştırmalısınız.

wsl --set-default-version 2

Adım 6 - İstediğiniz Linux dağıtımını kurun

Ubuntu 20.04 sürümü için doğrudan indirme bağlantısını buraya bırakıyorum.

Bunun yanı sıra, terminal üzerinden kurulabilecek diğer güncel Linux dağıtımlarını listelemek için:

wsl --list --online

İstediğiniz bir dağıtımı (örneğin Ubuntu 24.04 LTS) doğrudan kurmak için ise aşağıdaki komutu kullanabilirsiniz:

wsl --install -d Ubuntu-24.04

Farklı bir sürüm tercih ederseniz Microsoft Store'u açarak dilediğiniz Linux dağıtımını aratıp arayüz üzerinden de yükleyebilirsiniz.

WSL 2 Sık Karşılaşılan Hatalar ve Çözümleri (Troubleshooting)

Kurulum sırasında veya sonrasında aşağıdaki hatalarla karşılaşırsanız bu çözüm adımlarını uygulayabilirsiniz:

• Hata: 0x80370102 (Virtual Machine Platform is not enabled / Sanal makine özelliği etkin değil)
  • Çözüm: Bu hata, bilgisayarınızda sanallaştırmanın kapalı olduğunu gösterir. Öncelikle BIOS/UEFI ayarlarınıza girerek Intel Virtualization Technology (VT-x) veya AMD-V seçeneğini etkinleştirin. Ardından 3. Adımdaki VirtualMachinePlatform özelliğinin PowerShell komutuyla kurulduğundan emin olun.
• Hata: 0x8007019e (Windows Subsystem for Linux has not been enabled / WSL etkinleştirilmedi)
  • Çözüm: 1. Adımdaki komutun başarıyla çalıştırıldığından ve bilgisayarınızı yeniden başlattığınızdan emin olun.
• Hata: WslRegisterDistribution failed with error: 0x80070003
  • Çözüm: Genellikle Windows güncellemelerinin eksik olmasından kaynaklanır. Windows Update üzerinden tüm bekleyen güncellemeleri yükleyin veya Linux çekirdeği güncelleme paketini (Adım 4) manuel olarak tekrar kurun.

Resmi Kaynaklar ve Faydalı Bağlantılar

Daha detaylı bilgi edinmek ve gelişmiş yapılandırmaları öğrenmek için Microsoft'un resmi dokümantasyonunu ziyaret edebilirsiniz:

• Resmi Microsoft WSL Kurulum Kılavuzu
• WSL'de Gelişmiş Ayarlar Yapılandırma Kılavuzu (.wslconfig)
• WSL Dağıtımlarını Yönetme ve Sorun Giderme SSS

Bu Yazıda Yapılan Değişiklikler

• 20.06.2026: Windows 11/Modern Windows 10 için tek komutla (wsl --install) kurulum yöntemi, güncel Ubuntu dağıtımları, sık karşılaşılan hatalar (Troubleshooting), resmi Microsoft dokümantasyon bağlantıları ve LLO (yapay zeka görünürlüğü) iyileştirmeleri eklendi.
• 11.05.2022: Yazı özeti düzenlendi.