🚀 NEW in v2.4.29: 35+ Speed Optimizations added today!Download Now →

Home/Fix/WSL (Windows Subsystem for Linux) Not Working

How to Fix WSL (Windows Subsystem for Linux) Not Working on Windows

WSL won't start, Linux distro errors, or WSL2 virtual machine not launching? Fix WSL installation, kernel updates, and distribution configuration on Windows 10 and 11.

Symptoms

You might be experiencing this problem if you notice:

  • "Windows Subsystem for Linux has no installed distributions" error
  • WSL command not recognized in Terminal
  • "Please enable the Virtual Machine Platform" error
  • Linux distribution crashes immediately after opening
  • WSL2 extremely slow or high memory usage
  • "The WSL 2 kernel file is not found" error message

Common Causes

  • WSL Windows feature not enabled
  • Virtual Machine Platform feature not enabled (required for WSL2)
  • WSL2 Linux kernel not installed or outdated
  • Virtualization disabled in BIOS/UEFI
  • Hyper-V or hypervisor conflicts
  • Corrupted Linux distribution installation

Solutions

Solution 1: Install WSL from Scratch

  1. 1Open Admin PowerShell
  2. 2Run: wsl --install
  3. 3This installs WSL2, Virtual Machine Platform, and Ubuntu by default
  4. 4Restart your computer when prompted
  5. 5After restart: Ubuntu will open and ask you to create a username and password
  6. 6If you want a different distro: wsl --install -d Debian (or Fedora, openSUSE, etc.)

Solution 2: Fix WSL2 Kernel Error

  1. 1If you get "WSL 2 kernel file is not found":
  2. 2Open Admin PowerShell and run: wsl --update
  3. 3This downloads and installs the latest WSL2 Linux kernel
  4. 4If that fails: download manually from https://aka.ms/wsl2kernel
  5. 5Run the MSI installer and restart
  6. 6Verify: wsl --status should show WSL2 as default version

Solution 3: Fix WSL2 Performance Issues

  1. 1WSL2 can consume a lot of RAM — create a .wslconfig to limit it:
  2. 2Create file: %UserProfile%\.wslconfig
  3. 3Add: [wsl2] then on the next line: memory=4GB (adjust to your needs)
  4. 4Also add: processors=2 to limit CPU cores
  5. 5Save the file and run: wsl --shutdown then reopen your distro
  6. 6For slow file access: keep files inside the Linux filesystem (~/), not /mnt/c/
FIXES THIS IN 5 MINUTES

Fix WSL (Windows Subsystem for Linux) Not Working Automatically

RescuePC Toolkit includes 109+ automated repairs that fix this problem with one click. No command line knowledge required.

Download Now - Free Trial

No credit card required • Works on Windows 10 & 11

Share this:XRedditLinkedInEmail