◆Error Codes Wiki

WSL Common Errors — Windows Subsystem for Linux Troubleshooting

Warningsystem

Overview

Fix common WSL (Windows Subsystem for Linux) errors including installation failures, networking issues, file system access errors, and WSL2 VM startup failures.

Key Details

  • WSL2 runs a real Linux kernel in a lightweight Hyper-V virtual machine
  • Common error: 'WslRegisterDistribution failed with error: 0x80370102' — virtualization not enabled
  • WSL2 requires: Windows 10 2004+, Virtual Machine Platform, and BIOS virtualization (VT-x/AMD-V)
  • File system access between Windows and WSL has performance implications (/mnt/c/ is slower)
  • WSL networking uses a virtual NAT network — localhost port forwarding may not work as expected

Common Causes

  • Virtualization not enabled in BIOS/UEFI settings
  • Virtual Machine Platform Windows feature not installed
  • Hyper-V conflicting with other virtualization software (VirtualBox, VMware)
  • WSL2 kernel update not installed
  • Insufficient disk space for WSL2 virtual hard disk

Steps

  1. 1Enable virtualization in BIOS: restart, enter BIOS, enable Intel VT-x or AMD-V
  2. 2Install required features: wsl --install (Windows 11) or enable 'Virtual Machine Platform' in Windows Features
  3. 3Update WSL: wsl --update from PowerShell (Administrator)
  4. 4Reset a broken WSL distro: wsl --unregister <distro> then reinstall from Microsoft Store
  5. 5Fix networking: wsl --shutdown then restart WSL to reset the network adapter
  6. 6Set WSL2 as default: wsl --set-default-version 2

Tags

wslwsl2linuxsubsystemvirtualization

Related Items

windows-hyperv-errors

More in System

windows-C000021A-status-system-process-terminatedWindows Error 0xC000021A — STATUS SYSTEM PROCESS TERMINATED
Critical
windows-C0000225-boot-configuration-errorWindows Error 0xC0000225 — Boot Configuration Error
Critical
windows-C000000F-boot-selection-failedWindows Error 0xC000000F — Boot Selection Failed
Critical
windows-80004005-unspecified-errorWindows Error 0x80004005 — Unspecified Error
Warning
windows-80070570-file-or-directory-corruptedWindows Error 0x80070570 — File or Directory Corrupted
Error
windows-system-0xc0000185Windows Error 0xC0000185 — Boot Device Inaccessible
Critical

Frequently Asked Questions

WSL1 translates Linux syscalls to Windows kernel calls. WSL2 runs a full Linux kernel in a VM. WSL2 has better compatibility and filesystem performance for Linux files.