documentation/dev-manual/start.rst

268 Windows) that uses `CROPS <https://github.com/crops/poky-container>`__,
270 can be a Windows machine capable of running Windows Subsystem For Linux
276    `Windows Subsystem for Linux v1 <https://en.wikipedia.org/wiki/Windows_Subsystem_for_Linux>`__.
279    `WSLv2 <https://docs.microsoft.com/en-us/windows/wsl/install-win10>`__.
357 Yocto Project on a Windows, Mac, or Linux machine.
359 Follow these general steps to prepare a Windows, Mac, or Linux machine
375    Pre-Windows 10 or Windows 10 "Home" version), you must install Docker
380    example, if your build host is running Microsoft Windows Version 10
390 … Windows <https://docs.docker.com/docker-for-windows/install/#install-docker-desktop-on-windows>`__
391       for Windows build hosts that meet requirements.
424    Windows).
442 Setting Up to Use Windows Subsystem For Linux (WSLv2)
445 With `Windows Subsystem for Linux
446 (WSLv2) <https://docs.microsoft.com/en-us/windows/wsl/wsl2-about>`__,
448 to build on Windows. You can set up a Linux distribution inside Windows
451 Follow these general steps to prepare a Windows machine using WSLv2 as
454 1. *Make sure your Windows 10 machine is capable of running WSLv2:*
455    WSLv2 is only available for Windows 10 builds > 18917. To check which
457    Windows and execute the command "ver".
462       Microsoft Windows [Version 10.0.19041.153]
466    instructions on how to upgrade to WSLv2 visit `Windows 10
467    WSLv2 <https://docs.microsoft.com/en-us/windows/wsl/wsl2-install>`__
469 2. *Install the Linux distribution of your choice inside Windows 10:*
470    Once you know your version of Windows 10 supports WSLv2, you can
479 3. *Check your Linux distribution is using WSLv2:* Open a Windows
482       C:\WINDOWS\system32> wsl -l -v
492    https://docs.microsoft.com/en-us/windows/wsl/wsl2-about.
494 5. *Launch your WSL Distibution:* From the Windows start menu simply
508       open a Windows Powershell as Administrator and run::
510          C:\WINDOWS\system32> Get-AppxPackage -Name "*Ubuntu*" | Select PackageFamilyName
527    2a. *Optimize your VHDX file using Windows Powershell:*
530        option on Windows. Then, open a Windows Powershell as Administrator to
533          C:\WINDOWS\system32> wsl --shutdown
534 …C:\WINDOWS\system32> optimize-vhd -Path C:\Users\myuser\AppData\Local\Packages\CanonicalGroupLimit…
538        Windows Explorer.
543        Hyper-V. Not all SKUs of Windows can install Hyper-V. As an alternative,
544        use the DiskPart tool. To start, open a Windows command prompt as
547          C:\WINDOWS\system32> wsl --shutdown
548          C:\WINDOWS\system32> diskpart
561    flashed on hardware through Windows, but your build directory should