This is the first release of Bash on Windows and it is branded “beta” deliberately – it’s not yet complete! You should expect many things to work and for some things to fail! We greatly appreciate you using Bash on Windows and helping us identify the issues we need to fix in order to deliver a great experience.
To find your PC’s CPU architecture and Windows version/build number, open Settings>System>About. Look for the OS Build and System Type fields.
If your build is below 14393, try checking for updates.
In order to run Bash on Windows, you will need to manually:
Open a PowerShell prompt as administrator and run:
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
Restart your computer when prompted
It is important that you DO restart when prompted as some of the infrastructure which Bash on Windows requires can only be loaded during Windows’ boot-up sequence.
After you have accepted the License, the Ubuntu user-mode image will be downloaded and a “Bash on Ubuntu on Windows” shortcut will be added to your start menu.
To launch Bash on Windows, either run
bash at a cmd/PowerShell command-prompt, or use the start menu shortcut.
After installation your Linux distribution will be located at:
%localappdata%\lxss\ This directory is marked as a hidden system folder for a very good reason:
Avoid creating and/or modifying files in this location using Windows tools and apps! If you do, it is likely that your Linux files will be corrupted and data loss may occur. Please read this blog post for more information.
The first time you install Bash on Windows, you will be prompted to create a UNIX username and password.
This UNIX username and password can be different from, and has no relationship to your Windows username and password.