Setup & Config WSL

Sebelum menggunakan WSL Dashboard, sistem Windows Anda harus mengaktifkan dan mengonfigurasi lingkungan WSL 2 dengan benar. Dokumen ini terdiri dari tiga bagian utama:

1. Mengaktifkan dan Mengonfigurasi WSL: Menyelesaikan instalasi dan konfigurasi dasar WSL 2.
2. Perintah Tersedia Tidak Berarti Instalasi Berhasil: Menjelaskan bahwa perintah wsl dapat dieksekusi tidak berarti Linux dapat berhasil diinstal.
3. Pemecahan Masalah Instalasi Gagal: Cara memeriksa dan memperbaiki saat instalasi masih gagal setelah konfigurasi selesai.

1. Mengaktifkan dan Mengonfigurasi WSL

Bab ini akan memandu Anda menyelesaikan pengaturan dasar yang diperlukan. Setelah menyelesaikan bab ini, silakan baca Bab 2 untuk memahami perbedaan antara perintah yang tersedia dan instalasi yang berhasil; jika instalasi masih bermasalah, lihat Bab 3.

1.1 Memeriksa Persyaratan Sistem

WSL 2 memiliki persyaratan minimum versi Windows. Tekan Win + R, masukkan winver untuk memeriksa versi Anda:

• Windows 10: Versi 1903 atau lebih baru, dengan Build 18362 atau lebih tinggi.
• Windows 11: Semua versi didukung.

IMPORTANT

Jika versi Anda terlalu rendah, silakan tingkatkan sistem Anda melalui "Windows Update" terlebih dahulu.

1.2 Mengaktifkan Virtualisasi Perangkat Keras

WSL 2 berjalan di atas teknologi virtualisasi, oleh karena itu Teknologi Virtualisasi (Virtualization Technology) harus diaktifkan di BIOS/UEFI motherboard.

• Cara memeriksa: Buka "Task Manager" -> tab "Performance" -> "CPU".
• Melihat status: Pastikan status "Virtualization" di pojok kanan bawah menampilkan "Enabled".
• Cara mengaktifkan: Jika belum diaktifkan, Anda perlu me-restart komputer untuk masuk ke pengaturan BIOS/UEFI, temukan opsi seperti Intel VT-x atau AMD-V dan atur menjadi Enabled.

1.3 Mengaktifkan Fitur Windows yang Relevan

Anda perlu mengaktifkan fitur "Subsistem Windows untuk Linux" dan "Platform Mesin Virtual" di Windows.

Metode A: Melalui Antarmuka Grafis (Direkomendasikan)

1. Tekan Win + S, cari dan buka "Turn Windows features on or off".
2. Centang dua item berikut:
   • Subsistem Windows untuk Linux (Windows Subsystem for Linux)
   • Platform Mesin Virtual (Virtual Machine Platform)
3. Klik "OK", dan restart komputer saat diminta.

Metode B: Melalui Baris Perintah (Akses Administrator)

Jalankan PowerShell sebagai Administrator dan jalankan perintah berikut:

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

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

Setelah selesai, silakan restart komputer secara manual.

1.4 Menginstal/Memperbarui Kernel WSL

Versi Windows modern dapat memperoleh pembaruan WSL melalui Microsoft Store.

• Alamat unduhan: Microsoft Store - Windows Subsystem for Linux
• Unduhan manual: Jika tidak dapat menggunakan Store, Anda dapat mengunduh paket instalasi .msixbundle atau .msi terbaru dari WSL GitHub Releases untuk instalasi offline.

1.5 Menetapkan WSL 2 sebagai Versi Default

Untuk memastikan distribusi yang baru diinstal menggunakan WSL 2 secara default, jalankan di terminal:

wsl --set-default-version 2

1.6 Masalah Umum

• Kesalahan 0x80370102: Biasanya karena virtualisasi tidak diaktifkan di BIOS, atau ada konflik dengan Hyper-V.
• Perpindahan antara WSL 1 dan WSL 2: Anda dapat menggunakan wsl --set-version <nama-distribusi> 2 untuk meningkatkan instance WSL 1 yang ada ke WSL 2.

2. Perintah Tersedia Tidak Berarti Instalasi Berhasil

Perintah seperti wsl --version, wsl -l -v dapat berjalan normal, bukan berarti sudah memiliki syarat untuk menginstal Linux. Keduanya berada pada tahap yang berbeda, tidak dapat disamakan.

Perintah tersedia, hanya berarti:

• ✅ Komponen WSL di Windows sudah diaktifkan/terinstal
• ✅ Alat baris perintah wsl.exe tersedia
• ✅ Sistem dapat mengenali perintah terkait WSL

Tetapi untuk berhasil menginstal distribusi Linux, masih perlu memenuhi syarat tambahan. Hal-hal yang umum menyebabkan kebuntuan:

1. Virtualisasi dimatikan: VT-x / AMD-V tidak diaktifkan di BIOS/UEFI, WSL 2 tidak dapat berjalan, atau melaporkan kesalahan virtualisasi saat menginstal distribusi (cara memeriksa lihat 1.2 Mengaktifkan Virtualisasi Perangkat Keras).
2. Versi/Build Windows terlalu rendah: WSL 2 memiliki persyaratan kernel dan versi, edisi Home dan image enterprise lama mungkin memiliki fitur yang tidak lengkap (cara memeriksa lihat 1.1 Memeriksa Persyaratan Sistem).
3. Distribusi Linux belum benar-benar diinstal: wsl -l -v hanya mencantumkan distribusi yang sudah diinstal, jika belum menginstal apa pun daftarnya akan kosong, bukan berarti Ubuntu dapat langsung dijalankan.
4. Masalah jaringan / Microsoft Store: wsl --install -d <distribusi> perlu mengambil image dari Store atau jaringan, jaringan perusahaan, proxy, dan firewall semuanya dapat memblokirnya.
5. Izin tidak memadai: Menginstal distribusi atau mengubah pengaturan WSL memerlukan izin Administrator.

TIP

Singkatnya: perintah WSL bisa digunakan ≠ Linux sudah siap, hanya mendapatkan "tiket masuk", belum benar-benar menginstal sistem.

3. Pemecahan Masalah Instalasi Gagal

Setelah menyelesaikan konfigurasi sesuai Bab 1 (atau Anda merasa sudah menyelesaikan konfigurasi), jika wsl --install masih gagal, periksa sesuai urutan berikut.

3.1 Lakukan "Deteksi Satu Klik" Terlebih Dahulu

Jalankan PowerShell sebagai Administrator, lakukan secara berurutan:

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

• ✅ Jika kedua perintah ini dapat dijalankan dengan lancar, berarti komponen opsional WSL sudah diaktifkan, dan kondisi virtualisasi pada dasarnya terpenuhi.
• ❌ Jika gagal, akan langsung menampilkan apa yang kurang (seperti Platform Mesin Virtual, Hyper-V, virtualisasi BIOS, dll.).

Kemudian jalankan systeminfo, pastikan di output muncul Virtualization Enabled In Firmware: Yes. Jika tidak ada kesalahan di atas, Anda dapat dengan tenang menjalankan wsl --install untuk menginstal distribusi.

NOTE

Tidak ada perintah yang dapat 100% menjamin wsl --install pasti berhasil, tetapi deteksi di atas dapat memastikan apakah syarat instalasi sudah terpenuhi.

3.2 Daftar Periksa Deteksi Manual

Jika "Deteksi Satu Klik" masih belum dapat menemukan masalah, periksa satu per satu:

1. Deteksi apakah virtualisasi BIOS/firmware diaktifkan: Di PowerShell Administrator jalankan systeminfo, output harus menampilkan Virtualization Enabled In Firmware: Yes.
2. Deteksi apakah fitur Windows sudah diaktifkan:

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

   Status kedua perintah harus Enabled.
3. Deteksi apakah WSL tersedia: Jalankan wsl --version, seharusnya ada output normal; jika ditampilkan perintah tidak ditemukan, berarti komponen WSL belum terinstal, silakan kembali ke Bab 1.
4. Deteksi apakah WSL 2 dapat digunakan (kernel & platform mesin virtual): Jalankan wsl --set-default-version 2, seharusnya berhasil kembali. Penyebab kegagalan umum: Platform Mesin Virtual belum diaktifkan, atau VT-x / AMD-V belum diaktifkan di BIOS.

3.3 Referensi Cepat Penyebab Kegagalan Umum

Situasi	Penjelasan	Cara penanganan
Virtualisasi tidak diaktifkan di BIOS	Pasti gagal	Restart dan masuk ke BIOS untuk mengaktifkan VT-x / AMD-V (lihat 1.2)
Windows 10 di bawah 19041	wsl --install tidak didukung	Tingkatkan sistem (lihat 1.1)
Lingkungan perusahaan menonaktifkan Hyper-V / virtualisasi	Mungkin gagal	Hubungi administrator sistem
Sistem edisi Home lama	Perlu instalasi manual	Instal kernel WSL secara manual sesuai 1.4

3.4 Kesalahan 0xc03a0014: Tidak Dapat Menemukan Penyedia Dukungan Disk Virtual

Pesan kesalahan: Cannot find a virtual disk support provider for the specified file. Ini bukan masalah pada distribusi Linux itu sendiri, melainkan stack disk virtual VHD/VHDX Windows tidak berfungsi normal, WSL 2 gagal saat mendaftarkan distribusi, membuat/memasang ext4.vhdx.

Lakukan validasi minimal terlebih dahulu: Jalankan PowerShell sebagai Administrator, lakukan pengujian New-VHD (misalnya New-VHD -Path C:\test.vhdx -SizeBytes 1GB). Jika perintah ini juga melaporkan kesalahan yang sama, masalah 100% ada di sisi Windows, tidak ada hubungannya dengan distribusi.

Periksa dan perbaiki sesuai urutan berikut:

1. Layanan Virtual Disk tidak berjalan: Buka services.msc, temukan layanan Virtual Disk, atur jenis startup menjadi "Otomatis" dan mulai.

2. Fitur WSL / Platform Mesin Virtual belum diaktifkan (atau belum efektif): Jalankan kembali perintah di 1.3 Mengaktifkan Fitur Windows yang Relevan, lalu harus restart. Windows Home tidak memiliki Hyper-V lengkap, tetapi WSL 2 hanya membutuhkan Platform Mesin Virtual, bukan antarmuka manajemen Hyper-V.

3. Driver/perangkat disk virtual hilang: Buka Device Manager, periksa apakah ada di "Perangkat sistem / Pengontrol penyimpanan":

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

   Jika hilang, dapat ditambahkan secara manual melalui hdwwiz.exe (Pengontrol penyimpanan → Microsoft → Microsoft VHD Loopback Controller), dan pastikan layanan FsDepends tidak dinonaktifkan.

4. Image yang diimpor tidak memenuhi persyaratan WSL: Saat menggunakan wsl --import --vhd, VHDX harus berupa sistem file ext4, tidak boleh berupa disk terenkripsi LUKS, raw.img biasa, Live ISO, atau disk kosong yang diformat NTFS/FAT. .img / .qcow2 / .iso tidak dapat langsung wsl --import --vhd.

5. Masalah jalur/izin/sistem file: Direktori tujuan harus berada di disk NTFS (FAT32/exFAT tidak bisa); hindari karakter Tionghoa, spasi, dan simbol khusus di jalur; jangan impor dari network drive, OneDrive, atau folder terkompresi; pastikan menggunakan PowerShell Administrator yang sesungguhnya (bukan terminal biasa).

6. Komponen sistem rusak: Jalankan DISM dan SFC secara berurutan untuk memperbaiki komponen sistem, lalu coba lagi:

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

TIP

Mesin virtual pihak ketiga (VirtualBox, VMware) atau fitur sandbox/penguatan keamanan dari perangkat lunak keamanan (seperti 360, Huorong) dapat mengganggu operasi disk virtual, saat memeriksa dapat menonaktifkannya sementara lalu mencoba lagi.