1.. _win-setup-alts:
2
3Windows alternative setup instructions
4######################################
5
6.. _win-wsl:
7
8Windows 10 WSL (Windows Subsystem for Linux)
9********************************************
10
11If you are running a recent version of Windows 10 you can make use of the
12built-in functionality to natively run Ubuntu binaries directly on a standard
13command-prompt. This allows you to use software such as the :ref:`Zephyr SDK
14<zephyr_sdk>` without setting up a virtual machine.
15
16.. warning::
17      Windows 10 version 1803 has an issue that will cause CMake to not work
18      properly and is fixed in version 1809 (and later).
19      More information can be found in `Zephyr Issue 10420`_
20
21#. `Install the Windows Subsystem for Linux (WSL)`_.
22
23   .. note::
24         For the Zephyr SDK to function properly you will need Windows 10
25         build 15002 or greater. You can check which Windows 10 build you are
26         running in the "About your PC" section of the System Settings.
27         If you are running an older Windows 10 build you might need to install
28         the Creator's Update.
29
30#. Follow the Ubuntu instructions in the :ref:`installation_linux` document.
31
32.. NOTE FOR DOCS AUTHORS: as a reminder, do *NOT* put dependencies for building
33   the documentation itself here.
34
35.. _Install the Windows Subsystem for Linux (WSL): https://msdn.microsoft.com/en-us/commandline/wsl/install_guide
36.. _Zephyr Issue 10420: https://github.com/zephyrproject-rtos/zephyr/issues/10420
37