How To Enable WSL In Windows 11 | The One-Command Setup

Enabling WSL on Windows 11 is done most simply by running wsl --install in an administrator PowerShell, then restarting your PC.

Windows Subsystem for Linux (WSL) lets you run a full Linux environment directly inside Windows without a virtual machine. The tricky part is knowing which method to use and what to do when something goes wrong. This guide walks you through the official Microsoft‑recommended path, then covers the manual route for offline setups and common pitfalls to avoid.

What Is WSL and Why Enable It?

WSL gives you a real Linux kernel, command‑line tools, and the ability to install distributions like Ubuntu or Debian right inside Windows 11. Developers use it to run bash scripts, use package managers, and test code without dual‑booting. The feature is built into Windows, but it must be turned on explicitly.

The single fastest way to enable everything—including the optional VirtualMachinePlatform component and a default distro—is the wsl --install command in an elevated PowerShell. Microsoft now treats this as the primary installation method for supported systems.

What You Need Before You Start

Before running any commands, verify your system meets the requirements. The table below lists every prerequisite and how to check it.

How Do I Enable WSL with a Single Command?

The simplest and most reliable route is the one‑line command Microsoft provides. Follow these steps exactly.

1. Open PowerShell as Administrator – right‑click the Start button and select Windows PowerShell (Admin) or Terminal (Admin). Confirm the UAC prompt.
2. Run the install command – type wsl --install and press Enter. The system downloads WSL, enables the required features, and installs a default Linux distribution (usually Ubuntu).
3. Restart your computer when prompted. If no prompt appears, reboot anyway to finalize the changes. After restart, the distro will finish its setup.

That’s it. After restart, you’ll see a Linux terminal window where you can create a username and password. Your WSL environment is ready to use.

Can I Enable WSL Without the Command Line?

Yes – the manual or offline path exists for systems without internet or for users who prefer the traditional Windows Features dialog. This method is also necessary if you need a specific distro version that isn’t the default.

1. Open Windows Features – search for “Turn Windows features on or off” and open it.
2. Enable two components – check Windows Subsystem for Linux and Virtual Machine Platform. Click OK.
3. Restart when prompted.
4. Download and install a distro – either from the Microsoft Store or by using a .wsl file for offline install. If using the latter, first download the WSL MSI package from Microsoft’s GitHub releases and install it.
5. Launch the distro – after installation, start it from the Start menu. It will initialize and prompt for a username/password.

One common mistake: enabling only one of the two features. Both must be checked for WSL 2 to work properly. If you skip VirtualMachinePlatform, WSL will fall back to WSL 1, which lacks the full Linux kernel.

Enabling WSL in Windows 11: The Official Step Order

Microsoft’s documentation is clear about the hierarchy of steps. The most stable approach is the command‑line path because it automatically enables the correct optional features and installs the latest WSL kernel. The manual path works but requires you to enable components in the correct order: features first, then reboot, then distro installation. Both methods are supported, but the command is less error‑prone.

If you ever see an error like “The virtual machine could not be started,” the likely cause is disabled hardware virtualization. Enter your BIOS/UEFI (often by pressing F2 or Del during boot) and look for Intel VT‑x, AMD‑V, or SVM Mode – enable it, save, and boot back into Windows.

WSL Setup Checklist: What to Do After Enabling

Once WSL is enabled, your environment isn’t complete until you’ve set up your distro and verified it works. Here’s a final sequence to run through:

• Open your installed distro from the Start menu.
• Create a Linux username and password when prompted – this is separate from your Windows account.
• Update the package list: sudo apt update && sudo apt upgrade (for Ubuntu/Debian).
• Confirm WSL version: wsl -l -v in PowerShell – ensure it shows version 2 for your distro.
• If you need a different distro, install it from the Microsoft Store or via wsl --install -d <name>.

After these steps, you can access Linux tools from inside Windows, run bash scripts, and integrate with Windows apps.