WSL Setup

Sadurunge nggunakake WSL Dashboard, sistem Windows sampeyan kudu ngaktifake lan ngatur lingkungan WSL 2 kanthi bener. Dokumen iki dipérang dadi telung bagéan utama:

1. Ngaktifake lan Ngatur WSL: Ngrampungake instalasi lan konfigurasi dhasar WSL 2.
2. Perintah sing Kasedhiya Ora Tegese Instalasi Sukses: Njlentrehake yen perintah wsl bisa dieksekusi ora ateges bisa sukses nginstal Linux.
3. Ngatasi Masalah Instalasi Gagal: Cara mriksa lan ndandani nalika instalasi isih gagal sawise konfigurasi rampung.

1. Ngaktifake lan Ngatur WSL

Bab iki bakal nuntun sampeyan ngrampungake setelan dhasar sing dibutuhake. Sawise ngrampungake bab iki, wacanen Bab 2 kanggo mangerteni bedane antarane perintah sing kasedhiya lan instalasi sukses; yen instalasi isih ana masalah, wacanen Bab 3.

1.1 Priksa syarat sistem

WSL 2 nduweni syarat minimal versi Windows. Pencet Win + R, ketik winver kanggo mriksa versi sampeyan:

• Windows 10: Versi 1903 utawa mengko, kanthi Build 18362 utawa luwih dhuwur.
• Windows 11: Kabeh versi didhukung.

IMPORTANT

Yen versi sampeyan kurang dhuwur, mangga upgrade sistem liwat "Windows Update" dhisik.

1.2 Ngaktifake virtualisasi hardware

WSL 2 mlaku adhedhasar teknologi virtualisasi, mula kudu ngaktifake Virtualization Technology (Teknologi Virtualisasi) ing BIOS/UEFI motherboard.

• Cara mriksa: Bukak "Task Manager" -> tab "Performance" -> "CPU".
• Deleng status: Priksa manawa status "Virtualization" ing pojok tengen ngisor nuduhake "Enabled".
• Cara ngaktifake: Yen durung diaktifake, sampeyan kudu restart komputer kanggo mlebu setelan BIOS/UEFI, goleki pilihan sing padha karo Intel VT-x utawa AMD-V lan setel dadi Enabled.

1.3 Ngaktifake fitur Windows sing relevan

Sampeyan kudu ngaktifake fitur "Windows Subsystem for Linux" lan "Virtual Machine Platform" ing Windows.

Metode A: Liwat GUI (Disaranake)

1. Pencet Win + S, goleki lan bukak "Turn Windows features on or off".
2. Centhang rong item ing ngisor iki:
   • Windows Subsystem for Linux (Subsistem Windows kanggo Linux)
   • Virtual Machine Platform (Platform Mesin Virtual)
3. Klik "OK", lan restart komputer nalika dijaluk.

Metode B: Liwat baris perintah (Hak Administrator)

Jaluk PowerShell minangka Administrator lan eksekusi perintah ing ngisor iki:

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

# Ngaktifake Platform Mesin Virtual
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Sawise rampung, mangga restart komputer kanthi manual.

1.4 Instal / Nganyari kernel WSL

Versi Windows modern bisa entuk nganyari WSL liwat Microsoft Store.

• Alamat unduhan: Microsoft Store - Windows Subsystem for Linux
• Unduhan manual: Yen ora bisa nggunakake Store, sampeyan bisa ngunduh paket instalasi .msixbundle utawa .msi paling anyar saka WSL GitHub Releases kanggo instalasi offline.

1.5 Setel WSL 2 minangka versi bawaan

Kanggo mesthekake distribusi sing mentas diinstal nggunakake WSL 2 minangka standar, eksekusi ing terminal:

wsl --set-default-version 2

1.6 Pitakonan sing kerep ditakokake

• Kesalahan 0x80370102: Biasane amarga virtualisasi durung diaktifake ing BIOS, utawa ana konflik karo Hyper-V.
• Ngalih antarane WSL 1 lan WSL 2: Sampeyan bisa nggunakake wsl --set-version <jeneng-distribusi> 2 kanggo ngingkatake instance WSL 1 sing wis ana dadi WSL 2.

2. Perintah sing Kasedhiya Ora Tegese Instalasi Sukses

Perintah kaya wsl --version, wsl -l -v bisa dieksekusi kanthi normal, ora ateges wis nduweni syarat kanggo nginstal Linux. Kalorone ana ing tahap sing beda, ora bisa dipadhakake.

Perintah kasedhiya, mung ateges:

• ✅ Komponen WSL ing Windows wis diaktifake/diinstal
• ✅ Alat baris perintah wsl.exe kasedhiya
• ✅ Sistem bisa ngerteni perintah sing gegandhengan karo WSL

Nanging kanggo sukses nginstal distribusi Linux, isih kudu nyukupi syarat tambahan. Titik sing umum macet:

1. Virtualisasi dipateni: VT-x / AMD-V durung diaktifake ing BIOS/UEFI, WSL 2 ora bisa diwiwiti, utawa nglaporake kesalahan virtualisasi nalika nginstal distribusi (cara mriksa deleng 1.2 Ngaktifake virtualisasi hardware).
2. Versi/Build Windows kurang dhuwur: WSL 2 nduweni syarat kernel lan versi, edisi Home lan gambar enterprise lawas bisa uga fiture ora lengkap (cara mriksa deleng 1.1 Priksa syarat sistem).
3. Distribusi Linux durung bener-bener diinstal: wsl -l -v mung nampilake distribusi sing wis diinstal, yen durung nginstal apa-apa dhaptare kosong, ora ateges Ubuntu bisa langsung mlaku.
4. Masalah jaringan / Microsoft Store: wsl --install -d <distribusi> kudu njupuk gambar saka Store utawa jaringan, jaringan perusahaan, proxy, lan firewall kabeh bisa ngalang-alangi.
5. Izin ora cukup: Nginstal distribusi utawa ngowahi setelan WSL mbutuhake hak Administrator.

TIP

Cekake: perintah WSL bisa digunakake ≠ Linux wis siyap, mung entuk "karcis mlebu", durung bener-bener nginstal sistem.

3. Ngatasi Masalah Instalasi Gagal

Sawise ngrampungake konfigurasi miturut Bab 1 (utawa sampeyan rumangsa wis ngrampungake konfigurasi), yen wsl --install isih gagal, mangga priksa miturut urutan ing ngisor iki.

3.1 Lakokake "Deteksi Siji Klik" dhisik

Jaluk PowerShell minangka Administrator, eksekusi kanthi urut:

wsl --install --no-distribution
wsl --set-default-version 2

• ✅ Yen kaloro perintah iki bisa dieksekusi kanthi lancar, tegese komponen opsional WSL wis diaktifake, lan kondisi virtualisasi ing dhasare wis kacukupan.
• ❌ Yen gagal, bakal langsung nuduhake apa sing kurang (kaya Platform Mesin Virtual, Hyper-V, virtualisasi BIOS, lsp.).

Banjur eksekusi systeminfo, priksa ing output ana Virtualization Enabled In Firmware: Yes. Yen ora ana kesalahan ing ndhuwur, sampeyan bisa tenang ngeksekusi wsl --install kanggo nginstal distribusi.

NOTE

Ora ana perintah sing bisa njamin 100% wsl --install mesthi sukses, nanging deteksi ing ndhuwur bisa mesthekake apa syarat instalasi wis kacukupan.

3.2 Dhaptar Priksa Manual

Yen "Deteksi Siji Klik" isih durung bisa nemokake masalah, bisa dipriksa siji-siji:

1. Deteksi apa virtualisasi BIOS/firmware wis diaktifake: Ing PowerShell Administrator eksekusi systeminfo, output kudu katon Virtualization Enabled In Firmware: Yes.
2. Deteksi apa fitur Windows wis diaktifake:

   Get-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
   Get-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform

   Status kaloro perintah kudu Enabled.
3. Deteksi apa WSL kasedhiya: Eksekusi wsl --version, kudu ana output normal; yen nuduhake perintah ora ana, tegese komponen WSL durung diinstal, mangga bali menyang Bab 1.
4. Deteksi apa bisa nggunakake WSL 2 (kernel & platform mesin virtual): Eksekusi wsl --set-default-version 2 kudu bali sukses. Penyebab kegagalan umum: Platform Mesin Virtual durung diaktifake, utawa VT-x / AMD-V durung diaktifake ing BIOS.

3.3 Referensi Cepet Penyebab Kegagalan Umum

Kahanan	Panjelasan	Cara ngatasi
Virtualisasi durung diaktifake ing BIOS	Mesthi gagal	Restart mlebu BIOS ngaktifake VT-x / AMD-V (deleng 1.2)
Windows 10 ngisor 19041	Ora ndhukung wsl --install	Upgrade sistem (deleng 1.1)
Lingkungan perusahaan mateni Hyper-V / virtualisasi	Bisa gagal	Hubungi administrator sistem
Sistem edisi Home lawas	Perlu instalasi manual	Instal kernel WSL kanthi manual miturut 1.4

3.4 Kesalahan 0xc03a0014: Ora Bisa Nemokake Penyedia Dhukungan Disk Virtual

Pesen kesalahan yaiku Cannot find a virtual disk support provider for the specified file. Iki dudu masalah saka distribusi Linux dhewe, nanging tumpukan disk virtual VHD/VHDX Windows ora bisa mlaku normal, WSL 2 gagal nalika ndhaptar distribusi, nggawe/nggunakake ext4.vhdx.

Lakokake validasi minimal dhisik: Jaluk PowerShell minangka Administrator, eksekusi tes New-VHD (contone New-VHD -Path C:\test.vhdx -SizeBytes 1GB). Yen perintah iki uga nglaporake kesalahan sing padha, masalah 100% ana ing sisih Windows, ora ana hubungane karo distribusi.

Priksa lan ndandani miturut urutan ing ngisor iki:

1. Layanan Virtual Disk ora mlaku: Bukak services.msc, goleki layanan Virtual Disk, setel jinis wiwitan dadi "Otomatis" lan wiwiti.

2. Fitur WSL / Platform Mesin Virtual durung diaktifake (utawa durung efektif): Eksekusi maneh perintah ing 1.3 Ngaktifake fitur Windows sing relevan, banjur kudu restart. Windows Home ora nduweni Hyper-V lengkap, nanging WSL 2 mung butuh Platform Mesin Virtual, dudu antarmuka manajemen Hyper-V.

3. Driver/piranti disk virtual ilang: Bukak Device Manager, priksa ing "System devices / Storage controllers" apa ana:

   • Microsoft Virtual Disk Provider
   • Microsoft Virtual Drive Enumerator
   • Microsoft VHD Loopback Controller

   Yen ilang, bisa ditambahake kanthi manual liwat hdwwiz.exe (Storage controllers → Microsoft → Microsoft VHD Loopback Controller), lan priksa manawa layanan FsDepends ora dipateni.

4. Gambar sing diimpor ora cocog karo syarat WSL: Nalika nggunakake wsl --import --vhd, VHDX kudu sistem file ext4, ora bisa disk enkripsi LUKS, raw.img biasa, Live ISO, utawa disk kosong sing diformat NTFS/FAT. .img / .qcow2 / .iso ora bisa langsung wsl --import --vhd.

5. Masalah path/izin/sistem file: Direktori target kudu ana ing disk NTFS (FAT32/exFAT ora bisa); ngindhari karakter Tionghoa, spasi, lan simbol khusus ing path; aja ngimpor saka network drive, OneDrive, utawa folder terkompresi; mesthi nggunakake PowerShell Administrator sing bener (dudu terminal biasa).

6. Komponen sistem rusak: Eksekusi DISM lan SFC kanthi urut kanggo ndandani komponen sistem, banjur coba maneh:

   DISM.exe /Online /Cleanup-Image /RestoreHealth
   sfc /scannow

TIP

Mesin virtual pihak katelu (VirtualBox, VMware) utawa fitur sandbox/penguatan keamanan saka piranti lunak keamanan (kaya 360, Huorong) bisa ngganggu operasi disk virtual, nalika mriksa bisa dipateni sauntara banjur dicoba maneh.