Windows Subsystem for Linux (WSL) Error 414: “Not Installed” Troubleshooting Guide
Why This Error Happens
This error occurs because the Windows Subsystem for Linux feature has not yet been installed or enabled on your system, which is common on fresh Windows 11 installations. Additionally, the underlying Windows optional components—”Virtual Machine Platform” and “Windows Subsystem for Linux”—may be disabled at the OS level, preventing the wsl.exe command from finding a valid subsystem to interface with. In some cases, this can also occur if a previous installation was corrupted or incompletely removed.
Step-by-Step Resolution Guide
- Run the Simplified Install Command (Recommended for Win 11):
Open PowerShell or Command Prompt as Administrator and run:
wsl --install
This single command automatically enables the required optional components, downloads the Linux kernel, and installs Ubuntu as the default distribution.
- Manually Enable Required Windows Features (If Step 1 Fails):
If the simplified command doesn’t resolve the issue, manually enable the necessary components via PowerShell (Admin):
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
-
Restart Your Computer:
A restart is mandatory after enabling these components for the changes to take effect. Do not skip this step, as WSL will remain non-functional until the system reboots. -
Set WSL 2 as the Default Version:
After rebooting, open PowerShell and set the default version to ensure compatibility with modern distributions:
wsl --set-default-version 2
- Update the WSL Kernel Component:
If you still receive errors after enabling the features, manually update the kernel to ensure you have the latest version:
wsl --update
Alternative or Verification Steps
- Verify Installation: Run
wsl --list --verbosein a terminal. If configured correctly, this should list your installed distributions (e.g., Ubuntu) and their WSL version (1 or 2) without throwing an error. - Alternative (GUI Method): If command-line methods fail, open “Turn Windows features on or off” from the Start menu search bar, manually check the boxes for “Windows Subsystem for Linux” and “Virtual Machine Platform,” click OK, and restart your PC.