Windows 10’s new Ubuntu-based Bash shell doesn’t function like a normal program. To uninstall it or reset its state to get a fresh Linux environment, you’ll need to use a few special commands.
Update: As of the Fall Creators Update, you can now uninstall Ubuntu or any other Linux distribution like a normal application. For example, to uninstall Ubuntu, just right-click the Ubuntu shortcut in your Start menu and click “Uninstall”. To reinstall a Linux distribution, download it from the Store once again. When you reinstall, you’ll get a fresh copy of the Linux environment.
You can also run the
ubuntu clean command in a Command Prompt or PowerShell window to delete your Ubuntu Linux file system. The next time you launch Ubuntu, it will set up a new file system without you having to redownload the software.
All of the below commands can either be run in a Command Prompt window or a PowerShell window.
Right-click the Start button or press Windows+X on your keyboard and select “Command Prompt” to open a Command Prompt window. If you’d like to use PowerShell instead, you can launch PowerShell from the Start menu.
How to Uninstall the Ubuntu Environment and Keep Your Home Folder
wsl --unregister DistributionName
For example, to uninstall Ubuntu, you’d run:
wsl --unregister Ubuntu
You can run
wsl --list to see a list of installed Linux distributions and their names.
On older versions of Windows 10, to remove the downloaded Bash environment, open a Command Prompt window and run the following command. This will uninstall and delete the Ubuntu user environment from your system, including any Linux applications you downloaded and installed with apt-get or by compiling them from source.
Windows will ask you to confirm your choice. To automatically accept the confirmation–ideal if you want to use this command in a script, for example–run the
lxrun /uninstall /y command instead.
This command won’t delete your home folder and the files in it. If you’d like to completely wipe the Linux system, see the next section.
How to Uninstall the Ubuntu Environment and Delete Your Home Folder
The above command won’t delete your Ubuntu user account’s home folder. The home folder contains user preferences and files. If you install a new Ubuntu user space image, the files in your home folder will be preserved and carried over.
If you want to prevent this from happening, you’ll need to remove the downloaded Bash environment and completely wipe your home folder. To do so, run the following command:
lxrun /uninstall /full
You’ll be asked to confirm your choice. To automatically accept the confirmation, run the
lxrun /uninstall /y /full command instead.
How to Reinstall the Ubuntu Environment
To reinstall the Bash environment, you can just run the
bash command again, as you did when installing Bash the first time. If a Ubuntu user space image isn’t installed, it will automatically download and install it.
You can also run the following command yourself. This is the same command that bash.exe automatically runs if you launch it without a Ubuntu user space image installed.
Whether you run
lxrun /install , the command will ask you to confirm your choice and enter a username and password for the user account in the Bash environment.
To skip this process, you can run the following command instead. This command will automatically agree to the prompts, setting the “root” account as the default user account without a password. This is helpful if you want to automate the process of installing Bash in a script.
lxrun /install /y
How to Remove Windows 10’s Bash Tools Completely
If you’d like to remove the bash.exe tool and the Windows Subsystem for Linux from your computer completely, you’ll need to revisit the “Turn Windows Features On or Off” dialog in the Control Panel.
To find it, open the Control Panel and head to Programs > Turn Windows Features On or Off.
Uncheck the “Windows Subsystem for Linux” option here and click OK. Windows will uninstall the Windows Subsystem for Linux, bash.exe, and lxrun.exe commands. You can always revisit the Windows Features dialog to reinstall them in the future.