How to Install WSL2 Ubuntu on Windows 11 – Full Guide

Install WSL2 on Windows 11 — Install WSL2 on Windows 11 to run a Linux environment alongside your normal Windows desktop without setting up a traditional dual-boot system. Windows Subsystem for Linux, or WSL, is useful for developers, students and power users who need Linux command-line tools, package managers or project workflows. Microsoft provides a streamlined installation command that can enable the required components and install Ubuntu as the default distribution on supported systems. Before you begin, check your Windows build, virtualization support and available disk space. This guide explains the standard installation, first-run username setup, basic distribution commands and common troubleshooting steps. It also covers a few safe habits for working with files between Windows and Linux after the setup is complete.

What is WSL2 and why use Ubuntu?

Windows Subsystem for Linux lets you run a Linux distribution inside Windows. WSL 2 uses a lightweight virtualized Linux environment and is suitable for many development workflows, including shell tools, scripting, package managers and Linux-based project dependencies. Ubuntu is a popular starting distribution with a large documentation community. WSL is not the same as dual booting: you can open a Linux terminal while staying in Windows. Some specialized hardware or kernel workflows may need additional configuration, so check the documentation for your specific project.

Check Windows and virtualization requirements

Microsoft’s streamlined install command supports Windows 11 and Windows 10 version 2004 or later (Build 19041 or newer). Make sure Windows is updated and that hardware virtualization is enabled in your PC firmware. On some computers the setting may be labelled Intel Virtualization Technology, VT-x, AMD-V or SVM Mode. The name and location vary by manufacturer. If the PC is managed by an organization, firmware settings may be locked. Do not change unrelated firmware options while enabling virtualization.

Install WSL2 with one command

Open Windows Terminal or PowerShell as Administrator, then run the command below. The standard install flow enables the required Windows components and installs the default Ubuntu distribution on supported systems. When Windows asks for a restart, save your work and reboot. The first time Ubuntu launches, it may take a little while to unpack and initialize its files. Follow the on-screen prompts rather than closing the terminal while setup is still running.

First launch: create your Linux username

After Ubuntu starts for the first time, it asks you to create a Linux username and password. These credentials are for the Linux distribution and are separate from your Windows sign-in. When typing the password, the terminal may not display characters; that is normal for many Linux password prompts. Choose a username you can remember and store the password securely. You may be asked for the password when using administrative commands with sudo inside Ubuntu.

Check the installed distribution and WSL version

Open PowerShell or Windows Terminal and run wsl --list --verbose to see installed distributions and whether they use WSL 1 or WSL 2. The default distribution can be selected with wsl --set-default . If a distribution is shown as version 1 and you intend to use version 2, Microsoft documents wsl --set-version 2. Replace the placeholder with the exact name shown by the list command. Do not type the angle brackets around the name.

Update WSL and Ubuntu packages

Keep the WSL platform and Ubuntu packages updated separately. Use wsl --update from Windows to update WSL, then open Ubuntu and run sudo apt update followed by sudo apt upgrade to refresh installed packages. Review package changes before confirming. Updates can introduce new dependencies or require additional disk space, so save active work first. For development projects, keep a reproducible list of required packages or use a project-specific environment when appropriate.

Use Windows and Linux files safely

You can access Windows drives from Linux through mounted paths such as /mnt/c, while Windows can browse Linux distribution files through the supported WSL integration. For Linux command-line projects, Microsoft generally recommends keeping project files in the Linux file system for performance and compatibility. Avoid editing internal distribution files through unsupported system paths. Use version control and regular backups for important work, especially before moving or deleting project folders.

Install a different distribution if needed

Ubuntu is the default in the basic install flow, but other distributions may be available. Run wsl --list --online to view the list offered by your system, then install one with wsl --install -d . Names and availability can change, so use the exact value returned by the command. You can keep multiple distributions side by side and select a default one. Check each distribution’s documentation for package-management commands and setup differences.

Fix common WSL2 installation problems

If the install command is unavailable, confirm the Windows version and check Microsoft’s manual installation instructions. If a virtual machine platform error appears, review firmware virtualization and Windows optional features. If a download stalls, Microsoft documents a web-download option for some installation cases. If Ubuntu opens but commands fail, capture the complete error rather than deleting the distribution immediately. Removing a distribution can erase its Linux files, so export or back up important work first.

Know when WSL is the right tool

WSL2 is convenient for terminal-based development and many Linux utilities, but it is not a complete replacement for every Linux desktop or hardware workflow. A dedicated Linux installation, virtual machine or remote server may be more suitable for specialized kernel development, direct hardware access or production-like testing. Start with WSL for everyday command-line tasks, learn its file and networking model, and choose another environment only when your requirements call for it.

Final thoughts: This guide is intended as a practical starting point. Check the options available on your own device or platform, and confirm important changes before relying on them.

ToolXON.com – Practical technology guides and useful online tools.