add command line appx Linux instructions
authorAJ ONeal <aj@therootcompany.com>
Mon, 14 Sep 2020 12:18:48 +0000 (12:18 +0000)
committerAJ ONeal <aj@therootcompany.com>
Mon, 14 Sep 2020 12:18:48 +0000 (12:18 +0000)
wsl2/README.md

index f03a0f67c2e7e4425820e9edc7e22acbd603b9e9..4a7fbf6e808d1171c377feb1a846178ccd98863d 100644 (file)
@@ -26,7 +26,22 @@ You _will_ need to allow the installer to run as Admin when asked.
 
 You will not be able to use WSL without rebooting.
 
 
 You will not be able to use WSL without rebooting.
 
-### Switching Between WSL and WSL 2
+### How to Install Linux Bash
+
+You can download Linux from the Windows Store, or from the Command Line:
+
+```pwsh
+curl.exe -L -o Ubuntu_2004_x64.appx https://aka.ms/wslubuntu2004
+powershell Add-AppxPackage Ubuntu_2004_x64.appx
+```
+
+See also <https://docs.microsoft.com/en-us/windows/wsl/install-manual>.
+
+### How to Switch Between WSL 1 and WSL 2
+
+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.
 
 After rebooting you can set WSL 2 as the default:
 
 
 After rebooting you can set WSL 2 as the default:
 
@@ -46,6 +61,8 @@ And you can switch between using WSL and WSL 2 without an issues:
 wsl --set-version Ubuntu 2
 ```
 
 wsl --set-version Ubuntu 2
 ```
 
+See also <https://docs.microsoft.com/en-us/windows/wsl/wsl2-index>.
+
 ### Raw PowerShell Install Commands
 
 If you'd like to install manually, or create your own script, this is how we do
 ### Raw PowerShell Install Commands
 
 If you'd like to install manually, or create your own script, this is how we do
@@ -64,6 +81,8 @@ powershell -Command "Start-Process msiexec -Wait -ArgumentList '/a wsl_update_x6
 Copy-Item -Path "$env:TEMP\System32\lxss" -Destination "C:\System32" -Recurse
 ```
 
 Copy-Item -Path "$env:TEMP\System32\lxss" -Destination "C:\System32" -Recurse
 ```
 
+See also <https://github.com/microsoft/WSL/issues/5014>
+
 ### Nested VMs
 
 WSL2 may not work properly if you are already running Windows inside of a
 ### Nested VMs
 
 WSL2 may not work properly if you are already running Windows inside of a
@@ -75,3 +94,4 @@ Virtual Machine, especially if MacOS or Linux is the VM Host.
 - https://github.com/microsoft/WSL/issues/5014
 - https://docs.microsoft.com/en-us/windows/wsl/wsl2-index
 - https://aka.ms/wsl2kernel
 - https://github.com/microsoft/WSL/issues/5014
 - https://docs.microsoft.com/en-us/windows/wsl/wsl2-index
 - https://aka.ms/wsl2kernel
+- https://docs.microsoft.com/en-us/windows/wsl/install-manual