Step-by-Step Guide: Install Linux on Windows 11 with WSL (Easy, Reliable)

This guide explains how to install Linux on Windows 11 with WSL in a few reliable steps. The instructions cover prerequisites, the simplest command to enable WSL, how to choose and set up a distribution, and practical tips for common problems.

Detected intent: Transactional

install Linux on Windows 11 with WSL

The Windows Subsystem for Linux (WSL) provides a lightweight, integrated Linux environment that runs directly on Windows 11 without a separate virtual machine. WSL 2 uses a lightweight VM with a real Linux kernel, improving compatibility and performance. The approach below prioritizes speed and reliability: use the built-in installer, confirm virtualization settings, and perform a few post-install steps to make the environment useful for development or command-line tasks.

Prerequisites and what to check first

System requirements

• Windows 11 (recommended) or recent Windows 10 builds that support WSL 2.
• Hardware virtualization enabled in firmware (VT-x/AMD-V) for WSL 2.
• Administrative access to run PowerShell or Command Prompt as Administrator.

Why WSL 2 is usually the better choice

WSL 2 uses a real Linux kernel and offers better filesystem performance and compatibility for tools such as Docker. For small scripts or ultra-low-overhead tasks, WSL 1 can be acceptable, but the modern recommendation is WSL 2 unless a specific constraint requires WSL 1.

Step-by-step: Install Linux on Windows 11 with WSL

1. Open an elevated terminal: Right-click Start, choose Windows Terminal (Admin) or PowerShell (Admin).
2. Run the single-line installer: Execute wsl --install. This installs WSL, enables required features, downloads the default distro (Ubuntu), and sets WSL 2 as the default.
3. Reboot if prompted: A reboot may be required to finish enabling virtualization features.
4. Set up the distro: After reboot, open the distro from the Start menu (e.g., Ubuntu). Complete the first-time setup: create a username and password, then run sudo apt update && sudo apt upgrade -y.
5. Optional: install a specific distro: To install a different distribution, run wsl --install -d or install it from the Microsoft Store. Example: wsl --install -d Debian.
6. Optional: convert an existing distro to WSL 2: Check current version with wsl -l -v. Convert using wsl --set-version 2.

For official step details and troubleshooting, consult the Microsoft documentation: learn.microsoft.com - Install WSL.

WSL Install Checklist (named framework)

Use the "5-Step WSL Install Checklist" to confirm every critical item before trying to run Linux tools.

• Step 1: Confirm Windows build and enable virtualization in firmware.
• Step 2: Open an elevated terminal and run wsl --install.
• Step 3: Reboot and complete first-time distro setup (username, password).
• Step 4: Update packages inside the distro (sudo apt update && sudo apt upgrade).
• Step 5: Configure additional tools (GUI apps, Docker, VS Code Remote) as needed.

Post-install configuration and practical uses

Accessing files and editors

Windows files are available under /mnt/c. For a better development experience, use an editor that supports WSL integration (for example, an editor with a Remote - WSL extension) so the editor runs on Windows while the code and runtime stay inside the Linux environment.

Working with Docker and containers

Docker Desktop integrates with WSL 2. For many workflows, enable WSL integration in Docker Desktop settings so containers run inside the WSL 2 backend for improved performance compared with older Hyper-V approaches.

Practical tips

• Tip 1: If wsl --install fails, ensure the "Virtual Machine Platform" and "Windows Subsystem for Linux" optional features are enabled in Control Panel or by running dism /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart and similar for WSL.
• Tip 2: Use wsl -l -v to list distributions and versions; set the default with wsl --set-default-version 2.
• Tip 3: Keep the Linux kernel updated via wsl --update when available.
• Tip 4: For GUI apps, WSLg is included in Windows 11; graphical Linux apps run seamlessly without extra configuration in most cases.

Trade-offs and common mistakes

Trade-offs

• WSL 2 offers better compatibility and performance for Linux workflows but requires virtualized networking and a lightweight VM layer.
• WSL is not a full replacement for dedicated VMs when strict kernel customization or full isolation is required.

Common mistakes

• Attempting to install without virtualization enabled in BIOS — this causes install or conversion failures.
• Running heavy I/O workloads across /mnt/c frequently — store active projects inside the Linux filesystem for better performance.
• Not running the terminal as Administrator for initial installation — causes permission errors during feature enablement.

Short real-world example

Scenario: A web developer needs to run a Node.js build and a Postgres database locally. After running wsl --install and installing Ubuntu, the developer installs Node.js and Postgres inside the distro: sudo apt install nodejs npm postgresql. The code repository is cloned into the Linux home directory for fast builds, then the developer starts the database and runs the build scripts directly in WSL. Using an editor with WSL integration lets the editor run on Windows while terminal commands and runtime occur in Linux.

Core cluster questions

• How to enable WSL Windows 11 features before installation?
• How to set WSL 2 as the default version on Windows 11?
• How to install Ubuntu on WSL Windows 11 and update packages?
• How to convert an existing WSL 1 distro to WSL 2?
• How to run GUI Linux apps on Windows 11 using WSLg?

FAQ

How long does it take to install Linux on Windows 11 with WSL?

Typical install time is under 15 minutes on a modern machine: running wsl --install, rebooting if prompted, and completing first-time distro setup. Download time depends on internet speed and the chosen distribution image size.

Do Windows updates or builds affect WSL stability?

Occasional Windows updates can affect WSL behavior. Keeping Windows updated and using the official Microsoft WSL documentation for troubleshooting reduces risk. The WSL team documents known issues and provides kernel updates via wsl --update.

Can WSL run Docker and container workloads?

Yes. Docker Desktop integrates with WSL 2 for container workloads. Enabling WSL integration in Docker settings allows containers to run in the WSL 2 backend for improved performance.

How to enable WSL Windows 11 features if the installer fails?

Enable required Windows features manually: open an elevated PowerShell and run the DISM commands to enable "VirtualMachinePlatform" and "WindowsSubsystemForLinux", then reboot. If issues continue, verify virtualization is enabled in firmware and consult the official documentation.

How to install Linux on Windows 11 with WSL if the default distribution is not desired?

List available distributions with wsl --list --online. Install a specific one with wsl --install -d , or install from the Microsoft Store. After installation, update packages in the distro with the usual package manager commands.