X-Git-Url: https://git.josue.xyz/?a=blobdiff_plain;f=wsl2%2FREADME.md;h=e292fc2157837857bde094725e52d19e97c87b3a;hb=05b8f37fb5d32c221a8f32ffffeb03b1f1eae614;hp=4a7fbf6e808d1171c377feb1a846178ccd98863d;hpb=45ac060cf19857102341bfdad4a8618318d44ce0;p=webi-installers%2F.git

diff --git a/wsl2/README.md b/wsl2/README.md
index 4a7fbf6..e292fc2 100644
--- a/wsl2/README.md
+++ b/wsl2/README.md
@@ -2,68 +2,56 @@
 title: WSL 2 (Hyper-V)
 homepage: https://docs.microsoft.com/en-us/windows/wsl/wsl2-index
 tagline: |
-  WSL2 (Windows Subsystem for Linux 2) runs a true Linux kernel via Hyper-V emulation.
+  WSL2 (Windows Subsystem for Linux 2) runs a true Linux kernel via Hyper-V virtualization.
 ---
 
-## Cheat Sheet
-
-> WSL 2 uses `VirtualMachinePlatform` and Hyper-V to run a full Linux kernel
-> with 100% syscall compatibility.
-
-After installing WSL and **Rebooting** you will be able to install Linux
-variants from the Windows 10 Store:
+## Read Carefully!
 
-- [Ubuntu Linux 20.04](https://www.microsoft.com/store/apps/9n6svws3rx71)
-- [Alpine WSL](https://www.microsoft.com/store/apps/9p804crf0395)
+1. WSL is a **system** service which **requires Admin privileges** to install.
+2. A **System Reboot** is required **inbetween** install steps.
 
-### Admin Privileges Required
+## Cheat Sheet
 
-It is not possible to install WSL without Admin privileges.
+> WSL 2 uses `VirtualMachinePlatform` and Hyper-V to run a full Linux kernel
+> with 100% syscall compatibility. However, it does not work on all computers
+> and may not work in nested Virtual Machines - such as if running Windows in
+> VirtualBox or Parallels on Mac or Linux.
 
-You _will_ need to allow the installer to run as Admin when asked.
+This will install **WSL 1 and WSL 2 ONLY**.
 
-### Reboot Required
+**Most people** want [WSL 1 + WSL 2 + Linux](https://webinstall.dev/wsl). \
+(WSL 2 is NOT a replacement for WSL 1, it's just another _layer_ of WSL)
 
-You will not be able to use WSL without rebooting.
+See the **Full Cheat Sheet** at <https://webinstall.dev/wsl>.
 
-### How to Install Linux Bash
+### How to Install Linux
 
-You can download Linux from the Windows Store, or from the Command Line:
+Once WSL is installed you can download Linux from the Windows Store. We
+recommend:
 
-```pwsh
-curl.exe -L -o Ubuntu_2004_x64.appx https://aka.ms/wslubuntu2004
-powershell Add-AppxPackage Ubuntu_2004_x64.appx
-```
+- [Ubuntu Linux 20.04](https://www.microsoft.com/store/apps/9n6svws3rx71)
+- [Alpine WSL](https://www.microsoft.com/store/apps/9p804crf0395)
 
-See also <https://docs.microsoft.com/en-us/windows/wsl/install-manual>.
+### How to Switch to WSL 2 Manually
 
-### How to Switch Between WSL 1 and WSL 2
+To set WSL 2 for a specific Linux installation:
 
-Despite the name, WSL 2 is neither a "better" version of nor a replacement for
-WSL 1. Rather WSL 1 uses a syscall wrapper (much like WINE) whereas WSL 2 uses
-Hyper-V virtualization.
+1. List all installed Linux versions
+   ```pwsh
+   wsl --list --verbose
+   ```
+2. Set the desired version to WSL 2 with `--set-version`. For example:
+   ```pwsh
+   wsl --set-version Ubuntu-20.04 2
+   ```
 
-After rebooting you can set WSL 2 as the default:
+If WSL 2 works on your computer, you may set it as the default:
 
 ```pwsh
 wsl --set-default-version 2
 ```
 
-You can list your existing WSL Linuxes:
-
-```pwsh
-wsl --list --verbose
-```
-
-And you can switch between using WSL and WSL 2 without an issues:
-
-```pwsh
-wsl --set-version Ubuntu 2
-```
-
-See also <https://docs.microsoft.com/en-us/windows/wsl/wsl2-index>.
-
-### Raw PowerShell Install Commands
+### How to install WSL 2 with PowerShell
 
 If you'd like to install manually, or create your own script, this is how we do
 it:
@@ -75,15 +63,39 @@ dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux
 # Install VirtualMachinePlatform
 dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
 
-# Download and Install WSL Update (contains Microsoft Linux kernel)
+# Download and Install the WSL 2 Update (contains Microsoft Linux kernel)
 & curl.exe -f -o wsl_update_x64.msi "https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi"
-powershell -Command "Start-Process msiexec -Wait -ArgumentList '/a wsl_update_x64.msi /qb TARGETDIR=""$env:TEMP""'"
+powershell -Command "Start-Process msiexec -Wait -ArgumentList '/a ""wsl_update_x64.msi"" /quiet /qn TARGETDIR=""C:\Temp""'"
 Copy-Item -Path "$env:TEMP\System32\lxss" -Destination "C:\System32" -Recurse
+
+# Also install the WSL 2 update with a normal full install
+powershell -Command "Start-Process msiexec -Wait -ArgumentList '/i','wsl_update_x64.msi','/quiet','/qn'"
 ```
 
-See also <https://github.com/microsoft/WSL/issues/5014>
+See also <https://github.com/microsoft/WSL/issues/5014#issuecomment-692432322>
+
+### Error: Required Feature Not Installed
+
+> Installing, this may take a few minutes...
+>
+> Error: 0xXXXXXXXX The virtual machine could not be started because a required
+> feature is not installed.
+
+It may be that your computer does not support virtualization because:
+
+- it lacks hardware support in the CPU for VTx
+- VTx is disabled in the BIOS or EFI
+- Virtualization has disabled in Windows 10
+
+You should switch back to WSL 1 until you solve this problem:
+
+```pwsh
+wsl --set-default-version 1
+wsl --list --verbose
+wsl --set-version Ubuntu-20.04 1
+```
 
-### Nested VMs
+### Error: Nested Virtual Machines
 
 WSL2 may not work properly if you are already running Windows inside of a
 Virtual Machine, especially if MacOS or Linux is the VM Host.