Back to blog

WSL2 Stopped Working? Fixing `HCS_E_HYPERV_NOT_INSTALLED` with Root-Cause Diagnostics

3/8/2026 · 1 min · Infrastructure

Share

WSL2 Stopped Working? Fixing HCS_E_HYPERV_NOT_INSTALLED with Root-Cause Diagnostics

This error indicates a host virtualization issue, not a Linux distro issue.

Error context

Wsl/Service/CreateInstance/CreateVm/HCS/HCS_E_HYPERV_NOT_INSTALLED

HCS cannot provision the WSL2 VM because Hyper-V is not active at kernel boot.

Root-cause chain

  1. BIOS/UEFI virtualization enabled
  2. hypervisorlaunchtype=Auto
  3. VirtualMachinePlatform + WSL features enabled
  4. Virtualization services healthy

Structured fix

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
bcdedit /set hypervisorlaunchtype auto

Reboot and validate:

wsl --status
wsl -l -v

Advanced cases

Fallback

wsl --set-version <DistroName> 1

Use WSL1 only as contingency when Hyper-V cannot be enabled.

Conclusion

Treat this as a host orchestration incident. Fixing BIOS + BCD + features + services restores WSL2 reliably and avoids repetitive reinstallation noise.

CC BY-NC

This post is licensed under CC BY-NC.

Comments

Join the discussion below.