wsl2/README.md

   1 ---
   2 title: WSL 2 (Hyper-V)
   3 homepage: https://docs.microsoft.com/en-us/windows/wsl/wsl2-index
   4 tagline: |
   5   WSL2 (Windows Subsystem for Linux 2) runs a true Linux kernel via Hyper-V emulation.
   6 ---
   7
   8 ## Cheat Sheet
   9
  10 > WSL 2 uses `VirtualMachinePlatform` and Hyper-V to run a full Linux kernel
  11 > with 100% syscall compatibility.
  12
  13 After installing WSL and **Rebooting** you will be able to install Linux
  14 variants from the Windows 10 Store:
  15
  16 - [Ubuntu Linux 20.04](https://www.microsoft.com/store/apps/9n6svws3rx71)
  17 - [Alpine WSL](https://www.microsoft.com/store/apps/9p804crf0395)
  18
  19 ### Admin Privileges Required
  20
  21 It is not possible to install WSL without Admin privileges.
  22
  23 You _will_ need to allow the installer to run as Admin when asked.
  24
  25 ### Reboot Required
  26
  27 You will not be able to use WSL without rebooting.
  28
  29 ### How to Install Linux Bash
  30
  31 You can download Linux from the Windows Store, or from the Command Line:
  32
  33 ```pwsh
  34 curl.exe -L -o Ubuntu_2004_x64.appx https://aka.ms/wslubuntu2004
  35 powershell Add-AppxPackage Ubuntu_2004_x64.appx
  36 ```
  37
  38 See also <https://docs.microsoft.com/en-us/windows/wsl/install-manual>.
  39
  40 ### How to Switch Between WSL 1 and WSL 2
  41
  42 Despite the name, WSL 2 is neither a "better" version of nor a replacement for
  43 WSL 1. Rather WSL 1 uses a syscall wrapper (much like WINE) whereas WSL 2 uses
  44 Hyper-V virtualization.
  45
  46 After rebooting you can set WSL 2 as the default:
  47
  48 ```pwsh
  49 wsl --set-default-version 2
  50 ```
  51
  52 You can list your existing WSL Linuxes:
  53
  54 ```pwsh
  55 wsl --list --verbose
  56 ```
  57
  58 And you can switch between using WSL and WSL 2 without an issues:
  59
  60 ```pwsh
  61 wsl --set-version Ubuntu 2
  62 ```
  63
  64 See also <https://docs.microsoft.com/en-us/windows/wsl/wsl2-index>.
  65
  66 ### Raw PowerShell Install Commands
  67
  68 If you'd like to install manually, or create your own script, this is how we do
  69 it:
  70
  71 ```pwsh
  72 # Install WSL 1
  73 dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
  74
  75 # Install VirtualMachinePlatform
  76 dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
  77
  78 # Download and Install WSL Update (contains Microsoft Linux kernel)
  79 & curl.exe -f -o wsl_update_x64.msi "https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi"
  80 powershell -Command "Start-Process msiexec -Wait -ArgumentList '/a wsl_update_x64.msi /qb TARGETDIR=""$env:TEMP""'"
  81 Copy-Item -Path "$env:TEMP\System32\lxss" -Destination "C:\System32" -Recurse
  82 ```
  83
  84 See also <https://github.com/microsoft/WSL/issues/5014>
  85
  86 ### Nested VMs
  87
  88 WSL2 may not work properly if you are already running Windows inside of a
  89 Virtual Machine, especially if MacOS or Linux is the VM Host.
  90
  91 ## References
  92
  93 - https://docs.microsoft.com/en-us/windows/wsl/install-win10
  94 - https://github.com/microsoft/WSL/issues/5014
  95 - https://docs.microsoft.com/en-us/windows/wsl/wsl2-index
  96 - https://aka.ms/wsl2kernel
  97 - https://docs.microsoft.com/en-us/windows/wsl/install-manual