sodcalculator

10 Tech How-To

WSL Not Working in Windows 11? Fixes That Actually Work

Guide 10-49054 · Updated · Step by step

If WSL (Windows Subsystem for Linux) is not working in Windows 11, the fix is usually one of three things: enabling the required Windows features, updating the WSL kernel, or resetting the WSL installation. This article walks you through the most common causes and step-by-step solutions, from quick checks to deeper troubleshooting.

What Is WSL and Why Does It Fail?

WSL lets you run a full Linux distribution (like Ubuntu, Debian, or Kali) directly inside Windows without a virtual machine. It uses a lightweight compatibility layer that translates Linux system calls to Windows ones. Because it depends on several Windows components working together, a single missing update or disabled feature can break the whole thing.

Common failure points include:

  • Virtual Machine Platform or Windows Hypervisor Platform not enabled
  • Outdated or missing WSL kernel
  • Corrupted WSL configuration or distribution files
  • Conflicts with third-party antivirus or virtualization software
  • Windows 11 version not fully updated

First Things to Check

Before diving into complex fixes, verify the basics:

  1. Open Settings > Apps > Optional features and ensure “Windows Subsystem for Linux” is installed. If not, click “Add a feature” and install it.
  2. Open Settings > System > About and check your Windows 11 build. WSL requires at least version 21H2, but newer features need 22H2 or later.
  3. Restart your computer after any change to Windows features – many WSL issues disappear with a simple reboot.
  4. Run wsl --status in PowerShell or Command Prompt to see if WSL is recognized. If the command is not found, WSL isn’t installed.

Enable the Required Windows Features

WSL relies on two optional Windows features: Virtual Machine Platform and Windows Hypervisor Platform. You can enable them via PowerShell (as Administrator):

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

After running these, restart your PC. If you’re using WSL 2 (the default), you also need the Virtual Machine Platform. For WSL 1, only the Subsystem feature is required, but WSL 2 is recommended for full compatibility.

Update WSL to the Latest Version

Microsoft now ships WSL as a separate app from the Microsoft Store, so it updates independently of Windows. An outdated WSL version can cause “WSL is not working” errors, especially after a Windows feature update.

To update:

  1. Open the Microsoft Store and search for “Windows Subsystem for Linux”. If it’s installed, click “Update”.
  2. Alternatively, run wsl --update in an elevated PowerShell. This downloads the latest kernel and components.
  3. After updating, run wsl --version to confirm the version number. If it shows “WSL version: 2.x.x”, you’re good.

Reset or Reinstall Your Linux Distribution

If WSL itself works but a specific distribution fails to start, the distribution’s files may be corrupted. You can reset it without losing all your data (though it’s wise to back up important files).

To reset a distribution:

  1. Open Settings > Apps > Installed apps.
  2. Find your Linux distribution (e.g., Ubuntu), click the three-dot menu, and select Advanced options.
  3. Scroll down and click Reset. This will uninstall the distribution’s packages but keep your user files in the WSL filesystem.
  4. After reset, launch the distribution from the Start menu. It will reinitialize.

If that doesn’t work, uninstall the distribution entirely and reinstall it from the Microsoft Store. Your files inside WSL will be deleted, so back them up first (e.g., copy them to a Windows folder).

Common Error Messages and Their Fixes

Here are specific errors users often see:

  • “WSL is not installed” or “wsl is not recognized” – WSL isn’t enabled. Run the DISM commands above and restart.
  • “Please enable the Virtual Machine Platform” – Enable that feature via DISM or Windows Features dialog.
  • “The WSL optional component is not enabled” – Same as above; enable it and reboot.
  • “The requested operation is not supported” – This usually means your CPU doesn’t support virtualization or it’s disabled in BIOS. Check your BIOS settings for “Intel VT-x” or “AMD-V” and enable it.
  • “Error code: 0x80070003” – Often caused by a corrupted installation. Run wsl --shutdown and then wsl --unregister <distro> to remove the distribution, then reinstall it.
  • “Error: 0x80370102” – This indicates a problem with the Hyper-V hypervisor. Ensure Virtual Machine Platform is enabled and that no other hypervisor (like VirtualBox’s) is conflicting.

Advanced Troubleshooting: Check Virtualization and Hyper-V

WSL 2 uses a lightweight virtual machine, so your system must support hardware virtualization. You can check if it’s enabled by opening Task Manager > Performance and looking at the CPU section – it should say “Virtualization: Enabled”. If it says “Disabled”, you need to enable it in your BIOS/UEFI settings.

Also, if you have third-party virtualization software (e.g., VirtualBox, VMware) or Android emulators, they may conflict with Hyper-V. Try disabling them temporarily to see if WSL starts working.

Another advanced step is to reinstall the WSL kernel manually. Download the latest kernel from the Microsoft WSL release page and install it, then run wsl --shutdown and restart your distribution.

Frequently Asked Questions

Why does WSL stop working after a Windows update?

Windows updates can change feature states or introduce incompatibilities with the WSL kernel. After a major update, run wsl --update to get the latest kernel, and ensure the Virtual Machine Platform feature is still enabled. If the issue persists, restart your PC.

Can I use WSL without Hyper-V?

Yes, WSL 1 does not require Hyper-V, but WSL 2 does. If you want to avoid Hyper-V, you can set a specific distribution to use WSL 1 with wsl --set-version <distro> 1. However, WSL 2 offers better performance and full system call compatibility.

How do I completely uninstall WSL?

To remove WSL entirely, first unregister all distributions with wsl --unregister <distro> for each one. Then go to Settings > Apps > Optional features, uninstall “Windows Subsystem for Linux”, and run the DISM commands with /disable to turn off the features. Finally, uninstall the WSL app from the Microsoft Store.

Why is WSL not working in Windows 11 but worked in Windows 10?

Windows 11 has stricter security defaults, like Virtualization-Based Security (VBS) and Memory Integrity, which can interfere with WSL. Try disabling Memory Integrity temporarily (Settings > Privacy & Security > Windows Security > Device Security > Core Isolation) and see if WSL starts. If it does, you may need to keep it off or update your BIOS.

Does WSL work on ARM64 Windows 11?

Yes, WSL is supported on ARM64 devices, but some distributions may be slower or have compatibility issues. Ensure you have the latest WSL version and that your distribution supports ARM64 (most major ones do).

Can I run WSL without the Microsoft Store?

Yes, you can install WSL manually using the wsl --install command in an elevated PowerShell. This works even if the Store is unavailable. However, you may miss out on automatic updates.

Related

General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.

More in this bed

The whole Tech How-To bed →