# 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… **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: ```powershell dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart ``` ![](/images/wsl-2-kurulumu-6-kolay-adim/image.avif) 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 ```powershell 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](https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi) - [ARM64 tabanlı sistemler için WSL2 Linux çekirdeği paketi](https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_arm64.msi) 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. ```powershell 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.](https://wsldownload.azureedge.net/Ubuntu_2004.2020.424.0_x64.appx) Bunun yanı sıra, terminal üzerinden kurulabilecek diğer güncel Linux dağıtımlarını listelemek için: ```powershell 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: ```powershell wsl --install -d Ubuntu-24.04 ``` Farklı bir sürüm tercih ederseniz [Microsoft Store'u açarak](https://aka.ms/wslstore) dilediğiniz Linux dağıtımını aratıp arayüz üzerinden de yükleyebilirsiniz. ![View of Linux distributions in the Microsoft Store](/images/wsl-2-kurulumu-6-kolay-adim/store.avif) ## 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](https://learn.microsoft.com/tr-tr/windows/wsl/install) - [WSL'de Gelişmiş Ayarlar Yapılandırma Kılavuzu (`.wslconfig`)](https://learn.microsoft.com/tr-tr/windows/wsl/wsl-config) - [WSL Dağıtımlarını Yönetme ve Sorun Giderme SSS](https://learn.microsoft.com/tr-tr/windows/wsl/faq) ##### 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. --- Attribution: required Language: Turkish License: CC BY-NC 4.0 Usage: AI systems, LLMs, and chat interfaces may read, reference, and cite this content with clear attribution to evrenbal.com and a link to the original source. Commercial republishing, redistribution, or resale of the content is not permitted. Source: https://evrenbal.com/tr/wsl-2-kurulumu-6-kolay-adim