> ## Content Index > Fetch the complete content index at: https://elevendecoded.com/llms.txt > Use this file to discover other available public pages before exploring further. # How to Install WSL on Windows 11 and Get It Running Smoothly - URL: https://elevendecoded.com/install-wsl-windows-11/ - Published: 2026-10-04T06:00:00.000Z - Updated: 2026-10-21T06:57:13.000Z - Author: Md Fakharuddin - Tags: Windows 11, WSL, Linux, Installation To set up [and use the Windows](https://elevendecoded.com/install-windows-11/) [Subsystem for Linux](https://elevendecoded.com/bazzite-install-windows-11-subsystem/) (WSL) on Windows 11, you start by enabling the WSL feature and installing a Linux distribution. The easiest way is to run a single command in an administrator PowerShell, which enables WSL, installs the latest Linux kernel, sets WSL 2 as the default, and installs Ubuntu by default. This gives you a working Linux terminal inside Windows without complex setup or dual-booting, ready for development or learning. ## What’s the simplest way to install WSL on Windows 11? On a Windows 11 PC without WSL, open PowerShell as administrator and run wsl --install. This enables the necessary components and installs Ubuntu by default. Restart when requested, then launch Ubuntu to finish first-run setup and create its Linux user/password. The reboot and account setup mean this is not a completely unattended process. If you want a different Linux distribution, first check available options with wsl --list --online. Then install your choice by running wsl --install -d . For example, wsl --install -d Debian installs Debian. After installation, you launch your Linux distribution by typing its name in the Start menu or by running wsl in PowerShell or Command Prompt. If wsl --install displays help because WSL is already present, list online distributions and install one explicitly with wsl --install -d . If the distribution download stalls at 0.0%, Microsoft's documented alternative is wsl --install --web-download -d . Replace placeholders with an actual listed name. ![A Windows 11 laptop screen showing PowerShell with the 'wsl --install' command typed in.](https://tse1.mm.bing.net/th?q=Windows%2011%20laptop%20running%20PowerShell%20with%20WSL%20install%20command&w=624&h=352&c=7) ## Do I need to understand the differences between WSL 1 and WSL 2? Yes. WSL 1 translates Linux system calls into Windows calls, which makes it lightweight and fast to start, but it has some limitations in compatibility and performance for certain tasks. WSL 2 runs a real Linux kernel in a lightweight virtual machine, improving compatibility, performance, and support for complex applications like Docker. Windows 11 recommends WSL 2 for better overall performance and functionality. To check which WSL version your distributions use, run wsl -l -v in PowerShell or Command Prompt. This lists all installed distros and their version numbers. Before converting an existing distribution, back up important Linux files: conversion can take time and fail. Run wsl --set-version 2 using the installed name from wsl -l -v. The separate command wsl --set-default-version 2 affects future installations, not existing distributions. WSL 2 also needs supported virtualization and Virtual Machine Platform. ## What if the WSL installation or startup fails? If WSL fails to install or start, common causes include missing Windows features, disabled virtualization, or outdated system components. One frequent issue is that the Virtual Machine Platform feature is not enabled. You can enable it by running dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart in an elevated PowerShell or Command Prompt, then rebooting your PC. Another common cause is virtualization support being disabled in the BIOS or UEFI settings. Restart your PC, enter BIOS setup (usually by pressing F2, Delete, or Esc during boot), find virtualization options labeled Intel VT-x, AMD-V, or SVM, and enable them. Save changes and reboot. Keep Windows updated via Settings > Windows Update. Separately, wsl --update updates WSL itself, including its supplied components; it does not replace the package manager updates inside each Linux distribution. If the error remains, record its exact message and consult Microsoft's WSL troubleshooting guidance. Do not assume every failure means disabled virtualization: download, policy, networking, or distribution-specific errors require different fixes. ## How do I pick and install a Linux distribution inside WSL? Windows 11 offers several Linux distributions through the Microsoft Store, including Ubuntu, Debian, Kali Linux, openSUSE, and others. To choose one, open the Microsoft Store and search for "Linux" or the name of a specific distro. Each listing provides descriptions and user reviews. Click Install on the distribution you want. After installation, open it from the Start menu by typing its name. On first launch, you'll set up a Linux user account and password, which is separate from your Windows credentials. Alternatively, you can use command line: run wsl --list --online to see available distros, then install one with wsl --install -d . For example, wsl --install -d Debian installs Debian without using the Store interface. Choose a distro based on your needs: Ubuntu is a widely used general option, Debian is stable and lightweight, Kali focuses on security testing, and openSUSE is good for enterprise environments. Once installed, you can use your Linux shell like you would on a native Linux system. ## Once installed, how do I start and use WSL effectively? To start WSL, open the Start menu and type the name of your installed Linux distribution, like "Ubuntu", then launch it. You can also open PowerShell or Command Prompt and just type wsl to start the default Linux distribution. In Ubuntu or Debian, run sudo apt update, then sudo apt upgrade and review the proposed changes. These commands are not universal across distributions: use the selected distribution's package manager and documentation for openSUSE or other choices. With the usual automount configuration, /mnt/c/ exposes the Windows C: drive inside WSL. For Linux-heavy builds and tools, keep project files in the Linux filesystem, such as \~/projects, for better performance rather than working across /mnt/c/. Use mounted Windows files when that sharing is appropriate. For better workflow, use Windows Terminal to open WSL sessions with tabs and customization. You can also run Linux commands directly from PowerShell by prefixing them with wsl, for example, wsl ls. If you use Visual Studio Code, the Remote - WSL extension lets you develop inside WSL with full access to Linux tools and files. These steps help you use WSL as an integrated part of your Windows workflow for development or learning. ## Conclusion For a fresh setup, run wsl --install in administrator PowerShell, restart when required, and finish Ubuntu's first-run account setup. Confirm installed distributions with wsl -l -v. Update WSL and Linux packages separately. If installation fails, follow the exact error instead of repeatedly applying unrelated feature changes. ## Frequently Asked Questions ### Can I install multiple Linux distributions with WSL on Windows 11? Yes, you can install multiple Linux distributions side by side. Each runs independently, and you can launch them separately from the Start menu or by specifying the distro name with the wsl command. ### How do I switch a Linux distro from WSL 1 to WSL 2? Back up important files first, then run wsl --set-version 2 from Windows, using the exact installed distribution name. Ensure WSL 2 prerequisites are available and allow time for conversion; it can fail, so do not treat it as risk-free. ### Do I need to update WSL separately from Windows updates? Run wsl --update to update WSL separately from Windows servicing as needed. Packages inside Ubuntu, Debian, or another distribution still require that distribution's own package updates; updating WSL does not update all Linux applications. ### Why can’t I start WSL after installation? A pending restart, missing virtualization prerequisites, or other installation errors can prevent startup. Restart if requested and use the exact error to select a fix. Enabling virtualization alone does not guarantee every WSL startup problem is resolved.