Guide to install or uninstall Windows Subsystem for Linux on Windows 10 Anniversary Update and Creators Update
If you're running Windows 10 Creators Update or later, please follow the Windows 10 installation instructions.
The following instructions are for users running Windows 10 Anniversary Update or Windows 10 Creators Update
Prior to Windows 10 Fall Creators Update (version 1709), WSL was released as a beta feature and installed a single Ubuntu instance when "Bash on Ubuntu on Windows" (or Bash.exe) was first run.
While you CAN use WSL on earlier Windows 10 releases, this beta "legacy distro" is now considered obsolete. We strongly encourage you to run the most recent version of Windows 10 available. Each new Windows 10 release includes many hundreds of fixes and improvements in WSL alone, allowing ever more Linux tools and apps to run correctly on WSL.
If you cannot upgrade to Fall Creators Update or later, follow the steps below to enable and use WSL:
Turn on Developer Mode To run WSL on Windows 10 Anniversary Update or Creators Update, you must enable Developer Mode:
Open Settings -> Update and Security -> For developers
Select the Developer Mode radio button
The requirement to enable Developer Mode was removed in Windows 10 Fall Creators Update
Open a command prompt. Type
bashand hit enter
The first time you run Bash on Ubuntu on Windows, you'll be prompted to accept Canonical's license. Once accepted, WSL will download and install the Ubuntu instance onto your machine, and a "Bash on Ubuntu on Windows" shortcut will be added to your start menu.
The first time you run Bash on Ubuntu on Windows, you will be prompted to create a UNIX username and password. Follow the new distro instance instructions to complete your installation
Launch a new Ubuntu shell by either:
bashfrom a command-prompt
- Clicking the start menu "Bash on Ubuntu on Windows" shortcut
Uninstalling/Removing the legacy distro
If you upgrade to Windows 10 Fall Creators Update from an earlier Windows 10 release upon which you installed WSL, your existing distro will remain intact. However, we STRONGLY encourage you to install a new Store-delivered distro ASAP, and migrate any necessary files, data, etc. from your legacy distro to your new distro.
To remove the legacy distro from your machine, run the following from a Command Line or PowerShell instance:
wsl --unregister Legacy
If you are not using Windows Version 1903 or higher, you may need to run
wslconfig /u Legacy or
lxrun /uninstall /full instead.
Manually deleting the legacy distro
If you wish, you can manually delete your legacy instance. This may be required if you encounter issues uninstalling the legacy distro using
lxrun.exe, or are running Windows 10 Spring 2018 Update (or later) which do not ship with
To forcefully delete your legacy WSL distro, delete the
%localappdata%\lxss\ folder (and all it's sub-contents) using Windows' File Explorer, or the command-line:
rm -Recurse $env:localappdata/lxss/
DEL /S %localappdata%\lxss\