The Windows Subsystem for Linux (WSL) allows developers and advanced users to run Linux distributions directly on Windows without using a traditional virtual machine. With WSL, you can run Linux commands, install packages, develop applications, and access Linux tools seamlessly within Windows 11.
However, WSL may sometimes fail to install, launch, or update properly. Users may encounter errors such as “WSL is not recognized,” “WSL kernel update required,” “WSL failed to start,” or the Linux distribution may refuse to launch. These problems are typically caused by disabled Windows features, virtualization settings, outdated components, or corrupted system files.
If WSL is not working in Windows 11, follow the troubleshooting steps below.
How to Fix WSL Not Working in Windows 11
Work through each solution in order. After completing a step, try launching WSL again.
1. Restart Your PC
Temporary system glitches can prevent WSL from launching.
- Close all open applications.
- Press Windows + X.
- Select Shut down or sign out > Restart.
- After restarting, try opening WSL again.
Restarting refreshes system services and virtualization components.
2. Ensure WSL Is Installed Properly
If WSL is not installed correctly, it may fail to run.
- Press Windows + S and search for Command Prompt.
- Right-click it and select Run as administrator.
- Run the following command:
wsl --install - Wait for installation to complete.
- Restart your PC.
This installs WSL along with the default Linux distribution.
3. Enable Required Windows Features
WSL requires specific Windows components to function.
- Press Windows + R.
- Type:
optionalfeatures - Press Enter.
- Enable the following features:
- Windows Subsystem for Linux
- Virtual Machine Platform
- Click OK.
- Restart your PC.
After rebooting, try launching WSL again.
4. Enable Virtualization in BIOS/UEFI
WSL 2 requires hardware virtualization.
- Restart your PC.
- Enter BIOS/UEFI settings (usually by pressing F2, Del, or F10 during startup).
- Locate the virtualization setting.
- Enable:
- Intel VT-x (Intel processors)
- SVM Mode (AMD processors)
- Save changes and exit BIOS.
Once virtualization is enabled, WSL should run properly.
5. Update the WSL Kernel
If the WSL kernel is outdated, it may cause startup errors.
- Open Command Prompt as administrator.
- Run:
wsl --update - Wait for the update to finish.
- Restart your PC.
Updating the kernel ensures compatibility with Windows updates.
6. Set WSL 2 as the Default Version
Some Linux distributions require WSL 2.
- Open Command Prompt as administrator.
- Enter:
wsl --set-default-version 2 - Press Enter.
- Restart your PC.
This ensures all new distributions use WSL 2.
7. Reset or Reinstall the Linux Distribution
A corrupted distribution may prevent WSL from launching.
- Press Windows + I.
- Go to Apps > Installed apps.
- Find your Linux distribution (such as Ubuntu).
- Click Advanced options.
- Select Reset.
If the issue persists:
- Uninstall the distribution.
- Reinstall it from the Microsoft Store.
8. Run System File Checker (SFC)
Corrupted system files can break WSL functionality.
- Press Windows + S and search for Command Prompt.
- Right-click and select Run as administrator.
- Enter:
sfc /scannow - Press Enter and wait for the scan to complete.
- Restart your PC.
Windows will repair damaged files automatically.
9. Run DISM Scan
If SFC does not resolve the problem:
- Open Command Prompt as administrator.
- Run:
DISM /Online /Cleanup-Image /RestoreHealth - Wait for the process to finish.
- Restart your PC.
This repairs deeper system image corruption.
10. Install Windows Updates
Outdated Windows builds may cause WSL compatibility issues.
- Press Windows + I.
- Go to Windows Update.
- Click Check for updates.
- Install available updates.
- Restart your PC.
Updates often fix WSL-related bugs.
Conclusion
If WSL is not working in Windows 11, the issue is usually caused by disabled Windows features, missing virtualization support, outdated WSL components, or corrupted system files. In most cases, enabling the required features and updating the WSL kernel resolves the problem quickly.
By following the troubleshooting steps above, you should be able to restore WSL functionality and run Linux distributions smoothly on your Windows 11 system. If the issue persists, reinstalling the Linux distribution or verifying BIOS virtualization settings may help identify the underlying cause.
