If you want to try out the improved Windows Subsystem for Linux 2 (aka WSL 2) in the latest Windows versions here’s how — we cover everything you need to do to install it in this post.
WSL 2 is a major upgrade over the original version of WSL Microsoft introduced in 2017. More than a mere version bump, WSL 2 is faster, more versatile, and uses a real Linux kernel. And new Linux kernel updates are released as Windows 10 software updates — which is kind crazy when you think about it! Microsoft’s goal in creating WSL 2 is to boost performance. And the best way to do that? Add full system call compatibility, i.e. put a real Linux kernel at the heart of matters. “[This] new architecture presents a better platform for the WSL team to deliver features that make WSL an amazing way to run a Linux environment in Windows,” say Microsoft of the tech. The crazy shows no sign of abating either as Microsoft plans to let users run desktop Linux apps on Windows 10 and leverage GPU-intensive tasks. And the best news is that it is much easier to install WSL on Windows 10, as our updated guide shows.
Install WSL 2 on Windows 10
RequirementsTo install WSL 2 on Windows 10 you need:
- Windows 10 May 2020 (2004), Windows 10 May 2019 (1903), or Windows 10 November 2019 (1909) or later
- A computer with Hyper-V Virtualization support
If you use Windows 10 May 2020 (2004) update (or later) you can install WSL with a single command. If you don’t yet have the Windows 10 May 2020 (2004) update there are a couple of additional steps you’ll need to go through in order to get things set up. To use WSL your computer must support Hyper-V Virtualization. Not sure if yours does? You can check your Hyper-V support manually. If you don’t meet these requirements you cannot install or enable WSL 2 but you can use WSL 1.
Installing WSL 2 on OS Build 2004 (or later)
To install WSL 2 on Windows 10 OS Build 2004 or later you need to open the command prompt app with Administrator permissions, and enter the following command:
wsl.exe --installAs soon as you hit enter, the process automatically gets to work. It enables the WSL optional features required, fetches the latest WSL Linux kernel version, and installs Ubuntu as your default distro:
Once done, reboot and log in to Windows 10. The command prompt will open again and you’ll be walked through setting up Ubuntu with a username and password (these don’t need to be the same as your Windows username and password though). Once done you can open the ‘Ubuntu’ app from the Start Menu to get started, or install the Microsoft Terminal app to start exploring your newly-installed Ubuntu install — don’t forget to run an apt update && apt upgrade though!
Install WSL 2 (Old Method)If you use an earlier version of Windows 10 you can still install WSL 2 (Microsoft backported WSL 2 to older versions of Windows 10 in Windows Update KB4566116) but the process isn’t quite as simple as in the 2004 update. To install WSL 2 on Windows 10 (OS Build 1909 or 1903) you need to follow 4 steps:
- Enable WSL 2
- Enable ‘Virtual Machine Platform’
- Set WSL 2 as default
- Install a Linux distro
I walk through each step in turn below. I recommend using the PowerShell app, which you need to run as an administrator. You can find PowerShell in the Windows Start Menu. Note: it is possible to install WSL 1 using a GUI too but it’s much faster to use the command line, and since WSL is a CLI tool it kind makes sense too!
Step 1. Enable WSLRegardless of which version of WSL you want to use you first need to enable it. To do this open the PowerShell tool as an Administrator and run the command below. Be careful not to mistype or leave out any character in the command:
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
Step 2. Enable ‘Virtual Machine Platform’
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -NoRestart
Step 3. Set WSL 2 as default
wsl --set-default-version 2
Step 4. Install a distroWith WSL and the necessary virtualization tech all in place all that is left for you to do is pick and install a Linux distro from the Microsoft Store. Several different distros are available, including OpenSUSE, Penguins, Fedora Remix, and Alpine Linux. But my personal recommendation is (naturally) Ubuntu 20.04 LTS (though 18.04 LTS and 16.04 LTS are also available). To install Ubuntu on Windows 10 open the Microsoft Store app, search for “Ubuntu 20.04”, and hit the “Get” button: Ubuntu 20.04 LTS on the Microsoft Store
Whilst you in the Microsoft Store I highly recommend that you also install the open source Windows Terminal app. This tool is designed to give you the best possible WSL experience: Windows Terminal on the Microsoft Store
5. Use WSL 2When you installed Ubuntu (or a different Linux distro) a shortcut was added to the Start Menu. Use this to “open” Ubuntu (or whichever distro you chose). The first time you run the distro things will seem a little slow. This is expected; the distro has to unpack and decompress all of its contents — just don’t interrupt the process. You will also be promoted to set a username and password for use on the distro. Try to pick something you won’t forget.
Convert Ubuntu on WSL 1 to WSL 2If you use WSL 1 you can upgrade an existing WSL 1 installation to WSL 2. To convert an existing WSL 1 distro to WSL 2 run the following in PowerShell, e.g.,:
wsl.exe --set-version Ubuntu 2