Skip to content

Installation

From Microsoft Store

Open Store and search distro like Ubuntu or Debian.

Choose your distro and install it, you will have access from Start menu to define your username and password.

More

If don't want to install anything for Store, you can choose some other options.

Without Microsoft Store

From CLI

Find list of all distros

sh
wsl --list --online

Lists all available Linux distributions that you may install using the wsl command. Currently, these are:

  • Ubuntu: Ubuntu
  • Debian: Debian GNU/Linux
  • kali-linux: Kali Linux Rollin
  • openSUSE-42: openSUSE Leap 42
  • SLES-12 SUSE: Linux Enterprise Server v12
  • Ubuntu-16.04: Ubuntu 16.04 LTS
  • Ubuntu-18.04: Ubuntu 18.04 LTS
  • Ubuntu-20.04: Ubuntu 20.04 LTS

Install your distro

sh
wsl --install -d <DistroName>

With appx

You can download any distro in .appx format to install it.

Manual

You can manually download distros from docs.microsoft.com.

CommandLine

To find distro name, check link of each distro on docs.microsoft.com, some examples here:

  • wslubuntu2004
  • wsl-debian-gnulinux
PowerShell

Example with Ubuntu 20.04

ps1
Invoke-WebRequest -Uri https://aka.ms/wslubuntu2004 -OutFile Ubuntu.appx -UseBasicParsing
cURL

Example with Ubuntu 20.04

sh
curl.exe -L -o Ubuntu.appx https://aka.ms/wslubuntu2004

Install .appx

ps1
Add-AppxPackage .\Ubuntu.appx

MIT License