| .. _win-setup-alts: |
| |
| Windows alternative setup instructions |
| ###################################### |
| |
| .. _win-wsl: |
| |
| Windows 10 WSL (Windows Subsystem for Linux) |
| ******************************************** |
| |
| If you are running a recent version of Windows 10 you can make use of the |
| built-in functionality to natively run Ubuntu binaries directly on a standard |
| command-prompt. This allows you to use software such as the :ref:`Zephyr SDK |
| <toolchain_zephyr_sdk>` without setting up a virtual machine. |
| |
| .. warning:: |
| Windows 10 version 1803 has an issue that will cause CMake to not work |
| properly and is fixed in version 1809 (and later). |
| More information can be found in :github:`Zephyr Issue 10420 <10420>`. |
| |
| #. `Install the Windows Subsystem for Linux (WSL)`_. |
| |
| .. note:: |
| For the Zephyr SDK to function properly you will need Windows 10 |
| build 15002 or greater. You can check which Windows 10 build you are |
| running in the "About your PC" section of the System Settings. |
| If you are running an older Windows 10 build you might need to install |
| the Creator's Update. |
| |
| #. Follow the Ubuntu instructions in the :ref:`installation_linux` document. |
| |
| .. NOTE FOR DOCS AUTHORS: as a reminder, do *NOT* put dependencies for building |
| the documentation itself here. |
| |
| .. _Install the Windows Subsystem for Linux (WSL): https://msdn.microsoft.com/en-us/commandline/wsl/install_guide |