October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsClean PCRecommendedOne scan can reveal what keeps slowing WindowsLook for cleanup and repair opportunities.Run ScanOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
Redmond desk3 min

How to Install and Set Up WSL on Windows

Install WSL from an administrator PowerShell window, launch Ubuntu, create a Linux account, and verify your distribution and WSL version.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

To install WSL on a supported Windows 10 or Windows 11 PC, open PowerShell as an administrator, run wsl --install, restart if prompted, then launch Ubuntu and create a Linux username and password. The command installs WSL 2 and Ubuntu by default. For another distribution, install it by its listed name with wsl --install -d <DistroName>.

Check whether your Windows version supports the one-command install

Microsoft’s documented wsl --install route requires Windows 10 version 2004 (Build 19041) or later, or Windows 11. To check your Windows version and build, press Win + R, enter winver, and select OK. If your PC does not meet that requirement, use Microsoft’s manual installation guide for older versions and follow the instructions for your Windows build and processor architecture.

As an Amazon Associate I earn from qualifying purchases.

Install WSL and Ubuntu

  1. Open an elevated PowerShell window. Open Start, search for PowerShell, right-click it, and choose Run as administrator. Approve the Windows prompt if it appears.
  2. Run the installer. Enter wsl --install and press Enter. On this route, the command enables the required Windows components, installs the Linux kernel, sets WSL 2 as the default for new installations, and installs Ubuntu.
  3. Restart if Windows prompts you to. The installation may need a restart to finish enabling system features.
  4. Launch Ubuntu. Find Ubuntu in the Start menu and open it. On first launch, it unpacks its files; Microsoft says this can take a minute or two.
  5. Create your Linux account. Enter a Linux username and password when prompted. This account belongs to the Linux distribution and is separate from your Windows account. The password does not appear as you type, which is normal in a Linux terminal.

Choose a Linux distribution other than Ubuntu

Ubuntu is the default, but WSL supports other distributions. Check the current choices and their exact install names from PowerShell:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  1. Run wsl --list --online to see the distributions currently available.
  2. Install the option you want using its exact listed name: wsl --install -d <DistroName>. For example, replace <DistroName> with the name shown in the list.
  3. Launch the new distribution from the Start menu and complete its first-run account setup.

Available options can change, so use the live list rather than relying on an old list of distribution names. Microsoft’s WSL installation guide also explains the installation route and distribution selection.

#1 Best Overall

Verify the installation and check the WSL version

In PowerShell, run:

wsl --list --verbose

The output shows installed distributions, whether they are running or stopped, and whether each uses WSL 1 or WSL 2. The shorthand command wsl -l -v gives the same list. To start a distribution, open it from the Start menu or run wsl in a terminal.

WSL 2 is the default for distributions installed through the current one-command route. To set the default version for future installs, run wsl --set-default-version 2. This setting does not convert distributions that are already installed. To convert one, use wsl --set-version <DistroName> <Version>, replacing the placeholders with the exact distribution name and either 1 or 2. For example, wsl --set-version Ubuntu 2 converts a distribution named Ubuntu to WSL 2.

Rank #2
Dell Latitude 5420 14" FHD Business Laptop Computer, Intel Quad-Core i5-1145G7, 16GB DDR4 RAM, 256GB SSD, Camera, HDMI, Windows 11 Pro (Renewed)
  • 256 GB SSD of storage.
  • Multitasking is easy with 16GB of RAM
  • Equipped with a blazing fast Core i5 2.00 GHz processor.

Conversion can take time and may fail because WSL 1 and WSL 2 use different architectures. Back up important files before converting a distribution that contains a large project. Microsoft lists these commands and additional options in its basic WSL commands guide.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

If wsl --install does not install a distribution

The command displays help instead

If WSL is already installed, wsl --install may display command help rather than install a distribution. Run wsl --list --online, then install a distribution using wsl --install -d <DistroName> with a name from that list.

Rank #3
15.6 Inch Win 11 Laptop Computer, N4020, 4GB DDR4 RAM, 128GB Storage
  • WINDOWS 11 | STABLE PERFORMANCE: Powered by Intel Celeron N4020 processor and Windows 11 system, this laptop delivers stable performance for everyday computing tasks. It supports web browsing, online learning, document editing, email communication, and basic office work with optimized power efficiency, providing a practical and reliable experience for essential daily use for daily use.
  • 15.6” FHD IPS DISPLAY: Features a 15.6-inch Full HD IPS display with narrow bezels, offering wider viewing angles and clearer image details compared to standard panels. The improved screen-to-body ratio enhances visual experience for study, reading, document work, and video playback, making it suitable for both productivity and entertainment use.
  • 4GB DDR4 + 128GB eMMC STORAGE: Equipped with 4GB DDR4 memory and 128GB eMMC storage for everyday basics such as browsing, documents, email, and online learning platforms. The built-in TF card slot supports storage expansion up to 1TB, giving you more flexibility for files, photos, videos, and daily documents. TF card not included.
  • CONNECTIVITY & PORTS: Includes 1× TF card slot, 2× USB 3.2 Gen1 ports, and 2× full-featured Type-C ports (USB 3.2 Gen1). The Type-C ports support data transfer, charging, and video output, enabling flexible connection with external devices such as monitors, storage, and peripherals for daily work and study use.
  • LIGHTWEIGHT DESIGN | ONLINE COMMUNICATION: Designed with a slim, portable profile, this laptop is easy to carry for school, commuting, and travel. A built-in 1MP front camera supports online classes, video meetings, remote communication, and everyday conferencing. The 3300mAh battery works with the low-power system design to support practical daily use, while thermal optimization helps maintain quieter operation during extended tasks.

Your Windows build does not meet the one-command requirement

Check the version and build with winver. Microsoft’s manual procedure covers older Windows builds and requires you to enable the Windows Subsystem for Linux and Virtual Machine Platform features, install the kernel update, set the WSL 2 default if appropriate, and install a distribution. Requirements differ by Windows release and processor architecture; use the matching steps in the manual installation guide.

You cannot use Microsoft Store

If Store access is unavailable or system restrictions prevent the standard route, Microsoft’s manual guide explains how to download distribution packages directly. Follow its instructions for your Windows version rather than mixing older manual steps with the current wsl --install process.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

What to do after setup

Once the Linux prompt opens, you can use Linux commands and tools alongside Windows. WSL supports interoperability, including running Linux commands from PowerShell and launching Windows .exe programs from a WSL shell. For optional development setup such as VS Code, Git, databases, GUI apps, or GPU acceleration, see Microsoft’s WSL development environment guide. These are optional workflow choices, not prerequisites for installing WSL.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Quick Recap

Bestseller No. 1
HP 14' HD Laptop, Windows 11, Intel Celeron Dual-Core Processor Up to 2.60GHz, 4GB RAM, 64GB SSD, Webcam, Dale Pink (Renewed)
HP 14" HD Laptop, Windows 11, Intel Celeron Dual-Core Processor Up to 2.60GHz, 4GB RAM, 64GB SSD, Webcam, Dale Pink (Renewed)
14" diagonal, 1366x768 resolution, HD BrightView LED, Glossy NON-TOUCH Display
$245.99
Bestseller No. 2
Dell Latitude 5420 14' FHD Business Laptop Computer, Intel Quad-Core i5-1145G7, 16GB DDR4 RAM, 256GB SSD, Camera, HDMI, Windows 11 Pro (Renewed)
Dell Latitude 5420 14" FHD Business Laptop Computer, Intel Quad-Core i5-1145G7, 16GB DDR4 RAM, 256GB SSD, Camera, HDMI, Windows 11 Pro (Renewed)
256 GB SSD of storage.; Multitasking is easy with 16GB of RAM; Equipped with a blazing fast Core i5 2.00 GHz processor.
$285.00

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Outdated Drivers Are Slowing You DownFree scan - exact matches
PC Slower Than It Used to Be?Free scan - under a minute

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.