First of all, this feature is still in BETA. Some stuff might not work correctly and some will not work at all. Its Basically is running Ubuntu user-mode binaries provided by Canonical in Windows.

This is provided as beta software. While many of the coreutil commands provided by Ubuntu will work, there are some that will not.


  1. Microsoft Windows obviously :D
  2. Your PC must be running a 64-bit version of Windows 10 Anniversary Update build 14393 or later


  1. Turn-on Developer Mode:
    ... Open Settings -> Update and Security -> For developers
    ... Select the Developer Mode radio button
  2. Enable the “Windows Subsystem for Linux (beta)” feature:
    … From Start, search for “Turn Windows features on or off” (type ‘turn’)
    … Select Windows Subsystem for Linux (beta)

After you enable the “Windows Subsystem for Linux (beta)” feature you will be prompted to restart you PC. PLEASE DO NOT IGNORE THIS and do restart your PC.

Run Bash on Windows

  1. Open a command prompt (CMD). Type “cmd” in start.
  2. Type bash and hit enter.

You will be prompt to to accept the license. just type y and hit enter. 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.

Congratulation, you are done. Enjoy, and in case you run into an issue please refer to the feedback section below.


GitHub issue tracker
WSL Blog
Command-line UserVoice portal
Command-line team blog