WSL 2 kurulumu: Windows 10 ve 11 için güncel rehber

WSL 2'yi kurmak için artık altı ayrı kurulum adımıyla uğraşmanız gerekmiyor. Windows 10 sürüm 2004 (Derleme 19041) veya daha yeni bir sürüm ile Windows 11'de ana kurulum tek komutla yapılıyor.

WSL, Windows'tan ayrılmadan Linux dağıtımlarını ve komut satırı araçlarını kullanmanızı sağlar. Geleneksel bir sanal makineyi ayrıca kurup yönetmeden Linux tabanlı bir geliştirme ortamı açabilirsiniz.

💡 Özet (TL;DR):

• PowerShell'i yönetici olarak açın, wsl --install komutunu çalıştırın ve Windows'u yeniden başlatın.
• Varsayılan kurulum Ubuntu'yu yükler. Yeni kurulan dağıtımlar WSL 2 kullanır.
• Başka bir dağıtım için önce wsl --list --online, ardından wsl --install -d <DistroName> kullanın.
• Kurulumdan sonra wsl --update, wsl --status ve wsl --list --verbose komutlarıyla güncelleme ve sürüm kontrolü yapın.
• Eski kernel MSI ve doğrudan .appx indirme adımları güncel Windows sürümlerinde ana yöntem değildir.

Sistem gereksinimini kontrol edin

Bu rehberdeki tek komutlu kurulum için şu Windows sürümlerinden biri gerekir:

• Windows 11
• Windows 10 sürüm 2004 veya üzeri, Derleme 19041 veya üzeri

Sürümünüzü görmek için Windows + R tuşlarına basın, winver yazın ve Enter'a basın. Daha eski bir Windows derlemesi kullanıyorsanız Microsoft'un el ile kurulum sayfasına geçin.

WSL 2'yi tek komutla kurun

PowerShell'i Yönetici olarak çalıştır seçeneğiyle açın ve şu komutu girin:

wsl --install

Komut gerekli Windows özelliklerini etkinleştirir, güncel Linux çekirdeğini indirir, WSL 2'yi varsayılan yapar ve Ubuntu'yu kurar. İşlem tamamlandığında bilgisayarınızı yeniden başlatın.

Ubuntu'yu ilk açtığınızda dosyaların hazırlanmasını beklemeniz, ardından Linux için bir kullanıcı adı ve parola oluşturmanız istenir. Bu hesap Windows hesabınızdan ayrıdır.

WSL ile AI geliştirme araçlarını aynı ortamda kullanmak

WSL, AI ile geliştirme yapmak için şart değildir; ancak Windows ve Linux tarafında hangi aracın, hangi dosyalarla ve hangi terminalde çalıştığını netleştirir. Windows'ta açtığınız bir IDE veya masaüstü aracı WSL içindeki Linux oturumuna kendiliğinden geçmez. Proje dosyalarını Windows tarafında tutup araçları orada çalıştırabilir ya da dosyaları WSL dağıtımında tutup IDE'nizin WSL/uzak geliştirme entegrasyonunu kullanabilirsiniz. Aynı projeyi iki ayrı klasörde tutmak ise kısa sürede hangi dosyanın güncel olduğu sorununa dönüşür.

Terminal odaklı çalışıyorsanız, Claude Code veya Codex gibi araçları WSL dağıtımının içinde kurup kullanabilirsiniz. Bu durumda native Linux kullanan bir geliştirici gibi aynı kabukta, aynı yol yapısında, aynı paket yöneticileri ve proje araçlarıyla çalışırsınız. Agent'a komut vermeden önce hangi klasörde bulunduğunu ve Windows'ta mı, WSL içinde mi çalıştığını kontrol etmek gerekir; dosya yolları, bağımlılıklar ve çalıştırdığı komutlar bu bağlama göre değişir.

Bu blogda AI'ı araç listeleri üzerinden değil, gerçek projelerde neler yaptığımı ve hangi sınırlarla kullandığımı yazıyorum. WSL kurulumunu bitirdiğinizde ana sayfadaki yazılara bu gözle de bakabilirsiniz.

Farklı bir Linux dağıtımı kurun

Ubuntu yerine Debian, openSUSE veya listede bulunan başka bir dağıtımı kurmak istiyorsanız önce kullanılabilir dağıtımları görüntüleyin:

wsl --list --online

Listede görünen dağıtım adını aşağıdaki komutta <DistroName> yerine yazın:

wsl --install -d <DistroName>

Dağıtım adını tahmin etmek yerine listede yazıldığı biçimi kullanın. Böylece eski bir Ubuntu paketinin doğrudan indirme adresine bağlı kalmazsınız.

WSL bilgisayarınızda zaten kuruluysa wsl --install size yardım metnini gösterebilir. Bu durumda aynı şekilde wsl --list --online ile dağıtımları listeleyip wsl --install -d <DistroName> komutuyla kuruluma devam edin.

Kurulum yüzde 0,0'da takılırsa Microsoft'un belgelediği web indirme seçeneğini deneyebilirsiniz:

wsl --install --web-download -d <DistroName>

Kurulumu ve WSL sürümünü doğrulayın

Yüklü dağıtımların durumunu ve WSL 1 mi, WSL 2 mi kullandığını görmek için şu komutu çalıştırın:

wsl --list --verbose

Kısa biçimi wsl -l -v komutudur. Yeni wsl --install kurulumlarında dağıtımın VERSION sütununda 2 görünmelidir.

Daha önce WSL 1 ile kurulmuş bir dağıtımı WSL 2'ye çevirmek için önce dağıtım adını yukarıdaki listeden alın, ardından şu komutu kullanın:

wsl --set-version <DistroName> 2

Büyük bir dağıtımın dönüştürülmesi zaman alabilir. Microsoft, büyük projeler içeren dağıtımları dönüştürmeden önce dosyaların yedeklenmesini öneriyor.

WSL'yi güncelleyin ve durumunu kontrol edin

WSL'nin kendisini güncellemek için:

wsl --update

Varsayılan dağıtım, varsayılan WSL sürümü ve çekirdek sürümü gibi genel bilgileri görmek için:

wsl --status

Bu iki komut Linux dağıtımınızın kendi paket yöneticisinin yerini tutmaz. Örneğin Ubuntu içindeki paket güncellemeleri, Ubuntu terminalinde ayrıca yönetilir.

Eski altı adımlı kurulum ne zaman gerekli?

Bu yazının 2021'deki sürümünde WSL bileşenini ve Sanal Makine Platformu'nu ayrı ayrı açmak, Linux kernel güncelleme paketini MSI olarak kurmak, WSL 2'yi varsayılan sürüm yapmak ve Ubuntu paketini doğrudan indirmek gerekiyordu. Microsoft bu el ile kurulum akışını eski Windows sürümleri için hâlâ belgeliyor.

Yukarıdaki sürüm gereksinimini karşılayan bir Windows 10/11 kurulumunda bu adımları ana yöntem olarak uygulamayın. wsl --install başarısız olursa hata kodunu Microsoft'un sorun giderme sayfasında kontrol edin. El ile kuruluma gerçekten ihtiyaç varsa güncel paket ve komutları eski bağlantılardan değil, Microsoft'un el ile kurulum sayfasından alın.

Kurulum sorunları

0x80370102 hatası

Bu hata genellikle Sanal Makine Platformu özelliği veya donanım sanallaştırması kullanılamadığında görülür. Microsoft şu kontrolleri öneriyor:

• BIOS/UEFI içinde sanallaştırmanın etkin olduğunu doğrulayın. Ayarın adı ve yeri bilgisayar üreticisine göre değişir.
• Windows'taki Sanal Makine Platformu isteğe bağlı özelliğinin etkin olduğunu kontrol edin.
• Özelliği açtıktan sonra bilgisayarı yeniden başlatın.
• Windows'u başka bir sanal makinenin içinde çalıştırıyorsanız iç içe sanallaştırma desteğini ayrıca kontrol edin.

0x8007019e hatası

Bu kod, Linux için Windows Alt Sistemi isteğe bağlı bileşeninin etkin olmadığını gösterir. Güncel kurulumda wsl --install bu bileşeni açar. Hata devam ederse Microsoft'un sorun giderme ve el ile kurulum sayfalarındaki güncel komutları izleyin.

wsl --install çalışmıyor

Önce winver ile Windows sürümünü kontrol edin. Komut için gereken en düşük sürüm Windows 10 2004, Derleme 19041'dir. Sürüm gereksinimini karşılıyorsanız PowerShell'i yönetici yetkisiyle yeniden açın. Yardım metni görüyorsanız WSL zaten kurulmuş olabilir. Bu durumda dağıtımı wsl --install -d <DistroName> ile yükleyin.

Resmi kaynaklar

• Microsoft Learn: WSL'yi yükleme
• Microsoft Learn: WSL geliştirme ortamını kurma
• Microsoft Learn: WSL için temel komutlar
• Microsoft Learn: Eski WSL sürümleri için el ile yükleme
• Microsoft Learn: WSL sorunlarını giderme

Bu yazıda yapılan değişiklikler

• 27.08.2026: Ana kurulum wsl --install komutuna göre yeniden yazıldı. Eski kernel MSI ve Ubuntu 20.04 doğrudan indirme akışı ana yöntemden çıkarıldı. Dağıtım seçimi, sürüm kontrolü, güncelleme, sorun giderme ve AI ile geliştirme notu güncellendi.
• 20.06.2026: Tek komutla kurulum, güncel Ubuntu dağıtımları, sık karşılaşılan hatalar ve resmi Microsoft bağlantıları eklendi.
• 11.05.2022: Yazı özeti düzenlendi.