Konfigurasi WSL

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

1. Mengaktifkan dan Mengonfigurasi WSL: Menyelesaikan instalasi dasar dan konfigurasi WSL 2.
2. Perintah Tersedia Tidak Berarti Instalasi Berhasil: Menjelaskan bahwa perintah wsl yang dapat dieksekusi tidak berarti Linux dapat diinstal dengan sukses.
3. Pemecahan Masalah Kegagalan Instalasi: Metode pemeriksaan dan perbaikan 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 untuk versi Windows. Tekan Win + R, masukkan winver untuk memeriksa versi Anda:

• Windows 10: Versi 1903 atau lebih baru, dan nomor build (Build) harus 18362 atau lebih baru.
• Windows 11: Semua versi didukung.

IMPORTANT

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

1.2 Mengaktifkan Virtualisasi Perangkat Keras

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

• Metode Pemeriksaan: Buka "Task Manager (Pengelola Tugas)" -> tab "Performance (Kinerja)" -> "CPU".
• Lihat Status: Pastikan status "Virtualization" di kanan bawah menampilkan "Enabled (Diaktifkan)".
• Cara Mengaktifkan: Jika belum diaktifkan, Anda perlu me-restart komputer masuk ke pengaturan BIOS/UEFI, temukan opsi seperti Intel VT-x atau AMD-V dan atur ke Enabled.

1.3 Mengaktifkan Fitur Terkait Windows

Anda perlu mengaktifkan fitur "Windows Subsystem for Linux" dan "Virtual Machine Platform".

Metode A: Melalui Antarmuka Grafis (Disarankan)

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

Metode B: Melalui Baris Perintah (Hak Administrator)

Jalankan PowerShell sebagai administrator dan eksekusi perintah berikut:

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

# Mengaktifkan Virtual Machine Platform
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, eksekusi di terminal:

wsl --set-default-version 2

1.6 Pertanyaan Umum

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

2. Perintah Tersedia Tidak Berarti Instalasi Berhasil

Perintah seperti wsl --version dan wsl -l -v dapat dijalankan dengan normal, tidak berarti Anda sudah memiliki kondisi untuk menginstal Linux. Keduanya berada pada tahap yang berbeda dan 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

Namun untuk berhasil menginstal distribusi Linux, masih diperlukan kondisi tambahan. Tempat yang umum membuat macet antara lain:

1. Virtualisasi dimatikan: VT-x / AMD-V tidak diaktifkan di BIOS/UEFI, WSL 2 tidak dapat dimulai, atau melaporkan kesalahan virtualisasi saat menginstal distribusi (metode pemeriksaan lihat 1.2 Mengaktifkan Virtualisasi Perangkat Keras).
2. Versi/nomor build Windows terlalu rendah: WSL 2 memiliki persyaratan untuk kernel dan versi; edisi rumahan, citra perusahaan yang terlalu lama mungkin memiliki fungsi yang tidak lengkap (metode pemeriksaan lihat 1.1 Memeriksa Persyaratan Sistem).
3. Distribusi Linux belum benar-benar diinstal: wsl -l -v hanya mencantumkan distribusi yang sudah terinstal; jika belum menginstal apa pun, daftarnya kosong, itu tidak berarti Ubuntu dapat langsung dijalankan.
4. Masalah jaringan / Microsoft Store: wsl --install -d <distribusi> perlu menarik citra dari Store atau jaringan; jaringan perusahaan, proxy, firewall semuanya dapat menghalangi.
5. Izin tidak cukup: Menginstal distribusi atau mengubah pengaturan WSL memerlukan hak administrator.

TIP

Sederhananya: Perintah WSL bisa digunakan ≠ Linux sudah siap, hanya mendapatkan "tiket masuk", sistem belum benar-benar terinstal.

3. Pemecahan Masalah Kegagalan Instalasi

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

3.1 Lakukan "Pemeriksaan Satu Klik" Dulu

Jalankan PowerShell sebagai administrator, eksekusi secara berurutan:

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

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

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

NOTE

Tidak ada perintah yang dapat 100% menjamin wsl --install pasti berhasil, tetapi pemeriksaan di atas dapat memastikan apakah kondisi instalasi telah terpenuhi.

3.2 Daftar Periksa Manual

Jika "pemeriksaan satu klik" masih belum dapat menemukan masalah, periksa satu per satu:

1. Periksa apakah virtualisasi BIOS/firmware diaktifkan: Di PowerShell administrator jalankan systeminfo, output harus menunjukkan Virtualization Enabled In Firmware: Yes.
2. Periksa apakah fitur Windows telah diaktifkan:

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

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

3.3 Referensi Cepat Penyebab Kegagalan Umum

Situasi	Deskripsi	Cara Penanganan
Virtualisasi belum diaktifkan di BIOS	Pasti gagal	Restart masuk BIOS aktifkan VT-x / AMD-V (lihat 1.2)
Windows 10 di bawah 19041	Tidak mendukung wsl --install	Upgrade sistem (lihat 1.1)
Lingkungan perusahaan menonaktifkan Hyper-V / virtualisasi	Mungkin gagal	Hubungi administrator sistem
Sistem edisi rumahan lama	Perlu instalasi manual	Instal kernel WSL secara manual sesuai 1.4

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

Pesan error adalah Cannot find a virtual disk support provider for the specified file. Ini bukan masalah dari distribusi Linux itu sendiri, melainkan stack disk virtual VHD/VHDX Windows tidak berfungsi dengan normal, WSL 2 gagal saat mendaftarkan distribusi, membuat/mem-mount ext4.vhdx.

Lakukan validasi minimal dulu: Jalankan PowerShell sebagai administrator, jalankan tes New-VHD (misalnya New-VHD -Path C:\test.vhdx -SizeBytes 1GB). Jika perintah ini juga melaporkan error yang sama, masalahnya 100% ada di sisi Windows, tidak terkait dengan distribusi.

Periksa dan perbaiki sesuai urutan berikut:

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

2. Fitur WSL / Virtual Machine Platform belum diaktifkan (atau belum efektif): Jalankan kembali perintah di 1.3 Mengaktifkan Fitur Terkait Windows, lalu harus restart. Edisi rumahan Windows tidak memiliki Hyper-V lengkap, tetapi WSL 2 hanya memerlukan Virtual Machine Platform, bukan antarmuka manajemen Hyper-V.

3. Driver/perangkat disk virtual hilang: Buka Device Manager, periksa apakah ada di "System devices / Storage controllers (Perangkat sistem / Pengontrol penyimpanan)":

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

   Jika tidak ada, dapat ditambahkan secara manual melalui hdwwiz.exe (Storage controllers → Microsoft → Microsoft VHD Loopback Controller), dan pastikan layanan FsDepends tidak dinonaktifkan.

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

5. Masalah jalur/izin/file system: Direktori tujuan harus berada di disk NTFS (FAT32/exFAT tidak bisa); hindari karakter Cina, spasi, dan simbol khusus pada jalur; jangan impor dari disk jaringan, OneDrive, atau folder terkompresi; pastikan menggunakan PowerShell administrator yang sebenarnya (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 fungsi sandbox/penguatan dari perangkat lunak keamanan (seperti 360, Huorong) dapat mengganggu operasi disk virtual; saat memeriksa dapat menonaktifkannya sementara lalu mencoba lagi.