Mets Minor League Blog

Music theory, instruments and musicians

Mets Minor League Blog

Music theory, instruments and musicians

How to Install WSL2 on Windows 11 for Seamless Linux Support

By metsPosted on Posted in Sport Gear

How to Install WSL2 on Windows 11 for Seamless Linux Support

Windows Subsystem for Linux 2 (WSL2) is a powerful feature that allows you to run a full Linux environment directly within Windows 11. It provides a lightweight virtualization layer, enabling developers, system administrators, and tech enthusiasts to access Linux tools, scripts, and environments without leaving Windows. Installing WSL2 enhances productivity, simplifies development workflows, and opens up a vast ecosystem of Linux-based applications. Before starting, ensure your Windows 11 system is up to date, as WSL2 requires Windows 11 version 21H2 or later. Also, administrator privileges are necessary to enable features and install components.

What You’ll Need

  • Windows 11 PC with administrator access
  • Internet connection for downloading updates and components
  • Optional: a Linux distribution from the Microsoft Store (e.g., Ubuntu, Debian, Kali Linux)

Step-by-Step

  1. Ensure your Windows 11 is up to date. Open Settings > Windows Update and check for updates. Install any pending updates and restart your PC if prompted.
  2. Open PowerShell with administrator privileges. To do this, right-click the Start button and select “Windows Terminal (Admin)” or “PowerShell (Admin).” Confirm any prompts for permissions.
  3. Enable the Windows Subsystem for Linux feature. In PowerShell, run: 
     dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

    Wait for the command to complete.

  4. Enable the Virtual Machine Platform feature, which is required for WSL2. Run: 
     dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

    Again, wait for completion.

  5. Restart your computer to apply the changes.
  6. Set WSL2 as your default version. After restart, open PowerShell as administrator again and run: 
     wsl --set-default-version 2

    This ensures new Linux distributions will use WSL2 by default.

  7. Download and install a Linux distribution. Open the Microsoft Store app, search for your preferred Linux distro (e.g., Ubuntu 22.04 LTS), and click “Install.”
  8. Once installed, launch the Linux distribution from the Start menu. The first time you do this, it will take a few minutes to set up. You will be prompted to create a new user account and password for the Linux environment.
  9. Verify that WSL2 is running correctly. In PowerShell, run: 
     wsl -l -v

    You should see your installed distributions listed with the version “2.” If not, you can convert existing distributions by running: 

     wsl --set-version  2

Common Mistakes

  • Skipping the system restart after enabling features — this can prevent WSL2 from functioning properly.
  • Installing an older version of Windows — WSL2 requires Windows 11 version 21H2 or newer.
  • Not setting WSL2 as the default version — without this, new distributions may default to WSL1.
  • Attempting to run WSL without enabling the necessary features — always double-check feature activation.
  • Using an unsupported Linux distribution — ensure your distro is compatible with WSL2.

Tips

  • Regularly update your Linux distributions using their package managers (e.g., sudo apt update && sudo apt upgrade).
  • Use Windows Terminal for a better command-line experience, supporting multiple tabs and profiles.
  • Configure WSL integration with Windows file explorer for easy access to files: navigate to \wsl$ in File Explorer.
  • Back up your Linux environment periodically, especially if you customize configurations or install important tools.
  • Explore WSL extensions and tools such as WSLg for GUI app support or Docker integration for container workflows.

Troubleshooting

If WSL2 does not install or work correctly, try these steps:

  • Ensure your Windows 11 version is 21H2 or later. Check via Settings > System > About.
  • Re-run the feature enable commands and restart your PC.
  • If WSL2 is not set as default, run: 
     wsl --set-default-version 2
  • For issues with specific distributions, re-install or convert them using: 
     wsl --set-version  2
  • If virtualization is disabled in BIOS, enable Intel VT-x or AMD-V in your motherboard settings.
  • Update your Windows OS, as missing updates can cause compatibility issues.
  • Use the Windows Troubleshooter for network or performance issues related to WSL2.

Frequently Asked Questions

Can I run GUI Linux applications on WSL2?
Yes, with Windows 11, WSLg enables support for Linux GUI apps seamlessly.
Is WSL2 faster than WSL1?
Yes, WSL2 offers improved file system performance and full Linux kernel compatibility.
Do I need Hyper-V to run WSL2?
Hyper-V is required, but it is integrated into Windows 11 and enabled automatically when installing WSL2.
Can I use Docker with WSL2?
Yes, Docker Desktop integrates smoothly with WSL2, providing a native Linux container environment.
How do I upgrade an existing WSL1 distro to WSL2?
Run: 

 wsl --set-version  2

replacing with your distro’s name.

What if WSL2 installation fails during setup?
Check system requirements, enable features again, update Windows, and ensure virtualization is active in BIOS.

This comprehensive guide should help you get WSL2 up and running on your Windows 11 machine efficiently, unlocking the full potential of Linux tools within your Windows environment. Remember to keep your system updated and explore additional configurations to tailor WSL2 to your workflow needs.

Related

How to Install WSL2 on Windows 11 for Seamless Linux Support
Scroll to top