Konfigurasi WSL

Sadurunge nggunakake WSL Dashboard, sistem Windows sampeyan kudu ngaktifake lan ngonfigurasi lingkungan WSL 2 kanthi bener. Dokumen iki kapérang dadi telung bagian utama:

1. Ngaktifake lan Ngonfigurasi WSL: Ngrampungake instalasi dhasar lan konfigurasi WSL 2.
2. Printah Kasedhiya Ora Ateges Instalasi Sukses: Njlentrehake yen printah wsl sing bisa dieksekusi ora ateges Linux bisa diinstal kanthi sukses.
3. Pemecahan Masalah Gagal Instalasi: Cara mriksa lan ndandani nalika instalasi isih gagal sawise konfigurasi rampung.

1. Ngaktifake lan Ngonfigurasi WSL

Bab iki bakal nuntun sampeyan ngrampungake pangaturan dhasar sing dibutuhake. Sawise ngrampungake bab iki, wacanen Bab 2 kanggo mangerteni bedane antarane printah sing kasedhiya lan instalasi sing sukses; yen instalasi isih bermasalah, deleng Bab 3.

1.1 Mriksa Syarat Sistem

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

• Windows 10: Versi 1903 utawa luwih anyar, lan nomer build kudu 18362 utawa luwih anyar.
• Windows 11: Kabeh versi didhukung.

IMPORTANT

Yen versi sampeyan terlalu lawas, upgrade sistem sampeyan dhisik liwat "Windows Update".

1.2 Ngaktifake Virtualisasi Perangkat Keras

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

• Cara Mriksa: Bukak "Task Manager (Pengelola Tugas)" -> tab "Performance (Kinerja)" -> "CPU".
• Deleng Status: Priksa manawa status "Virtualization" ing sisih tengen ngisor nampilake "Enabled (Diaktifake)".
• Cara Ngaktifake: Yen durung diaktifake, sampeyan kudu restart komputer mlebu menyang pangaturan BIOS/UEFI, goleki opsi kaya Intel VT-x utawa AMD-V lan atur dadi Enabled.

1.3 Ngaktifake Fitur Terkait Windows

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

Cara A: Liwat Antarmuka Grafis (Disaranake)

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

Cara B: Liwat Baris Printah (Hak Administrator)

Jalanake PowerShell minangka administrator lan eksekusi printah ing ngisor iki:

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

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

Sawise rampung, monggo restart komputer kanthi manual.

1.4 Nginstal/Nganyari Kernel WSL

Versi Windows modern bisa entuk pembaruan 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 Nyetel WSL 2 minangka Versi Default

Kanggo njamin distribusi sing mentas diinstal nggunakake WSL 2 kanthi default, eksekusi ing terminal:

wsl --set-default-version 2

1.6 Pitakon Umum

• Error 0x80370102: Biasane amarga virtualisasi ora 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 upgrade instance WSL 1 sing ana menyang WSL 2.

2. Printah Kasedhiya Ora Ateges Instalasi Sukses

Printah kaya wsl --version lan wsl -l -v bisa dijalanake kanthi normal, ora ateges sampeyan wis duwe kondisi kanggo nginstal Linux. Loro-lorone ana ing tahap sing beda lan ora bisa disamakake.

Printah kasedhiya, mung ateges:

• ✅ Komponen WSL ing Windows wis diaktifake/terinstal
• ✅ Piranti baris printah wsl.exe kasedhiya
• ✅ Sistem bisa ngenali printah sing gegandhengan karo WSL

Nanging kanggo sukses nginstal distribusi Linux, isih dibutuhake kondisi tambahan. Panggonan umum sing nggawe macet antarane:

1. Virtualisasi dipateni: VT-x / AMD-V ora diaktifake ing BIOS/UEFI, WSL 2 ora bisa diwiwiti, utawa nglaporake kesalahan virtualisasi nalika nginstal distribusi (cara mriksa deleng 1.2 Ngaktifake Virtualisasi Perangkat Keras).
2. Versi/nomer build Windows terlalu lawas: WSL 2 duwe syarat kanggo kernel lan versi; edisi omah, citra perusahaan sing terlalu lawas bisa uga duwe fungsi sing ora lengkap (cara mriksa deleng 1.1 Mriksa Syarat Sistem).
3. Distribusi Linux durung bener-bener diinstal: wsl -l -v mung nyathet distribusi sing wis terinstal; yen durung nginstal apa-apa, dhaptare kosong, ora ateges Ubuntu bisa langsung dijalanake.
4. Masalah jaringan / Microsoft Store: wsl --install -d <distribusi> perlu narik citra saka Store utawa jaringan; jaringan perusahaan, proxy, firewall kabeh bisa ngalangi.
5. Izin ora cukup: Nginstal distribusi utawa ngowahi pangaturan WSL mbutuhake hak administrator.

TIP

Sederhanane: Printah WSL bisa digunakake ≠ Linux wis siap, mung entuk "tiket mlebu", sistem durung bener-bener terinstal.

3. Pemecahan Masalah Gagal Instalasi

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

3.1 Tindakake "Priksa Siji Klik" Dhisik

Jalanake PowerShell minangka administrator, eksekusi kanthi urut:

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

• ✅ Yen rong printah iki bisa dijalanake kanthi lancar, ateges komponen opsional WSL wis diaktifake lan kondisi virtualisasi dhasar wis terpenuhi.
• ❌ Yen gagal, bakal langsung ngandhani apa sing kurang (kaya Virtual Machine Platform, Hyper-V, virtualisasi BIOS, lsp.).

Banjur jalanake systeminfo, priksa manawa output nampilake Virtualization Enabled In Firmware: Yes. Yen ora ana error ing ndhuwur, sampeyan dhasar bisa kanthi tenang nindakake wsl --install kanggo nginstal distribusi.

NOTE

Ora ana printah sing bisa 100% njamin wsl --install mesthi sukses, nanging mriksa ing ndhuwur bisa njamin apa kondisi instalasi wis terpenuhi.

3.2 Dhaptar Priksa Manual

Yen "priksa siji klik" isih durung bisa nemokake masalah, priksa siji-siji:

1. Priksa apa virtualisasi BIOS/firmware diaktifake: Ing PowerShell administrator jalanake systeminfo, output kudu nampilake Virtualization Enabled In Firmware: Yes.
2. Priksa apa fitur Windows wis diaktifake:

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

   Status rong printah kudu Enabled.
3. Priksa apa WSL kasedhiya: Jalanake wsl --version kudu ana output normal; yen dijaluk printah ora ditemokake, ateges komponen WSL durung terinstal, monggo bali menyang Bab 1.
4. Priksa apa bisa nggunakake WSL 2 (kernel & Virtual Machine Platform): Jalanake wsl --set-default-version 2 kudu sukses. Panyebab kegagalan umum: Virtual Machine Platform durung diaktifake, utawa VT-x / AMD-V durung diaktifake ing BIOS.

3.3 Referensi Cepet Panyebab Kegagalan Umum

Situasi	Katrangan	Cara Penanganan
Virtualisasi durung diaktifake ing BIOS	Mesti gagal	Restart mlebu BIOS aktifake VT-x / AMD-V (deleng 1.2)
Windows 10 ing ngisor 19041	Ora ndhukung wsl --install	Upgrade sistem (deleng 1.1)
Lingkungan perusahaan mateni Hyper-V / virtualisasi	Bisa uga gagal	Hubungi administrator sistem
Sistem edisi omah lawas	Perlu instalasi manual	Instal kernel WSL kanthi manual miturut 1.4

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

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

Tindakake validasi minimal dhisik: Jalanake PowerShell minangka administrator, jalanake tes New-VHD (contone New-VHD -Path C:\test.vhdx -SizeBytes 1GB). Yen printah iki uga nglaporake error 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, atur tipe startup dadi "Otomatis" lan wiwiti.

2. Fitur WSL / Virtual Machine Platform durung diaktifake (utawa durung efektif): Jalanake maneh printah ing 1.3 Ngaktifake Fitur Terkait Windows, banjur kudu restart. Edisi omah Windows ora duwe Hyper-V lengkap, nanging WSL 2 mung mbutuhake Virtual Machine Platform, dudu antarmuka manajemen Hyper-V.

3. Driver/perangkat disk virtual ilang: Bukak Device Manager, priksa apa ana ing "System devices / Storage controllers (Perangkat sistem / Pengontrol panyimpenan)":

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

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

4. Citra sing diimpor ora nyukupi syarat WSL: Nalika nggunakake wsl --import --vhd, VHDX kudu format file system ext4, ora bisa disk terenkripsi LUKS, raw.img biyasa, Live ISO, utawa disk kosong format NTFS/FAT. .img / .qcow2 / .iso ora bisa langsung wsl --import --vhd.

5. Masalah jalur/izin/file system: Direktori tujuan kudu ana ing disk NTFS (FAT32/exFAT ora bisa); aja nganti ana karakter Cina, spasi, lan simbol khusus ing jalur; aja impor saka disk jaringan, OneDrive, utawa folder terkompresi; priksa manawa nggunakake PowerShell administrator sing sejatine (dudu terminal biyasa).

6. Komponen sistem rusak: Jalanake 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 fungsi sandbox/penguatan saka piranti lunak keamanan (kaya 360, Huorong) bisa ngganggu operasi disk virtual; nalika mriksa bisa mateni sementara banjur coba maneh.