You can now install Windows Subsystem for Linux (WSL) with a single command

Reading time icon 2 min. read


Readers help support MSPoweruser. When you make a purchase using links on our site, we may earn an affiliate commission. Tooltip Icon

Read the affiliate disclosure page to find out how can you help MSPoweruser effortlessly and without spending any money. Read more

In the latest Windows Insider Preview builds, you can install everything you need to run WSL just by running wsl.exe --install.

Today Microsoft announced that this functionality is now officially backported to Windows 10 version 2004 and higher.

Using wsl --install

Microsoft says the process to set up WSL was previously too complicated, involving turning on multiple settings and installing multiple packages. The company has simplified the process down to just one command. Windows 10 users can now simply open a command prompt window with admin privileges and run wsl.exe --install. Once you hit enter, the process will automatically enable the WSL optional features required, install the Ubuntu distribution by default, and install the latest WSL Linux kernel version onto your machine. When it’s completed and you restart your machine, your distribution will start after you boot up again, completing the installation.

Additionally, you can find a list of Linux distributions available to install by entering the command wsl --list --online in PowerShell or Windows Command Prompt. To install a distribution other than, or in addition to, the Ubuntu default, use this command: wsl --install -<DistroName>

Replace <DistroName> with the name of a Linux distribution found in the previous list command. This install command can be used for first time installation or for adding additional distributions after you already have WSL installed with the default Ubuntu distribution.

Additional commands

Microsoft also included some additional commands to help you manage your WSL instances with this backport.

You can use wsl --update to manually update your WSL Linux kernel, and you can use wsl --update rollback to rollback to a previous WSL Linux kernel version.

Lastly, you can use wsl --status to see general information about your WSL configuration, such as default distro type, default distro, and kernel version.

Update your Windows 10 version to support these commands

You can get this backport just by updating Windows like normal. To manually do this open Windows Settings, go to ‘Updates and Security’ and hit ‘Check for Updates’.

This update is part of KB5004296 and you can find full instructions on how to ensure you have it installed and its changes here. At the time of writing, when you click “Check for Updates” you might see an available optional update, ensure that it has the same number as KB5004296, install it, and you’ll get access to wsl --update.

More about the topics: windows, wsl 2