Open main menu

Changes

Add shortcut instructions in TLDR; and also reference to Docker docs on WSL
Like all things Windows, WSL is an executable binary c:\WINDOWS\system32\wsl.exe
 
==TLDR==
To get to a Linux command prompt fast, just open a PowerShell window (<kbd class="keyboard-key nowrap">⊞</kbd>+<kbd class="keyboard-key nowrap">R</kbd> type <code>powershell</code> <kbd class="keyboard-key nowrap">↵</kbd>) and type <code>wsl</code><kbd class="keyboard-key nowrap">↵</kbd> to launch an interactive shell in the default Linux container for your local environment.
==Prerequisites==
To install WSL on Windows, you have one requirement to meet; you must have a Windows 10 64-bit computer Build 18917 '''or later'''.
Press the '[[wp:Windows key|windows' key]] <kbd>⊞ Win</kbd> and type <code>winver</code> to run the Windows Version utility in order to see your current Windows version. ==See Also ==https://docs.docker.com/desktop/troubleshoot/topics/#working-with-git-bash == WSL Cheatsheet ==Once you have WSL plus a distribution installed, all you need to do to open a Linux shell is open the Windows PowerShell, and type <code>wsl</code> which will start the default distro. <pre>Copyright (c) Microsoft Corporation. All rights reserved. Usage: wsl.exe [Argument] [Options...] [CommandLine] Arguments for running Linux binaries:     If no command line is provided, wsl.exe launches the default shell.     --exec, -e <CommandLine>         Execute the specified command without using the default Linux shell.     --shell-type <Type>         Execute the specified command with the provided shell type.         Types:             standard                 Execute the specified command using the default Linux shell.             login                 Execute the specified command using the default Linux shell as a login shell.             none                 Execute the specified command without using the default Linux shell.     --         Pass the remaining command line as-is. Options:     --cd <Directory>         Sets the specified directory as the current working directory.         If ~ is used the Linux user's home path will be used. If the path begins         with a / character, it will be interpreted as an absolute Linux path.         Otherwise, the value must be an absolute Windows path.     --distribution, -d <Distro>         Run the specified distribution.     --user, -u <UserName>         Run as the specified user.     --system         Launches a shell for the system distribution. Arguments for managing Windows Subsystem for Linux:     --help         Display usage information.     --debug-shell         Open a WSL2 debug shell for diagnostics purposes.     --event-viewer         Opens the application view of the Windows Event Viewer.     --install [Distro] [Options...]         Install a Windows Subsystem for Linux distribution.         For a list of valid distributions, use 'wsl.exe --list --online'.         Options:             --no-launch, -n                 Do not launch the distribution after install.             --web-download                 Download the distribution from the internet instead of the Microsoft Store.     --mount <Disk>         Attaches and mounts a physical or virtual disk in all WSL 2 distributions.         Options:             --vhd                 Specifies that <Disk> refers to a virtual hard disk.             --bare                 Attach the disk to WSL2, but don't mount it.             --name <Name>                 Mount the disk using a custom name for the mountpoint.             --type <Type>                 Filesystem to use when mounting a disk, if not specified defaults to ext4.             --options <Options>                 Additional mount options.             --partition <Index>                 Index of the partition to mount, if not specified defaults to the whole disk.     --release-notes         Opens a web browser to view the WSL release notes page.     --set-default-version <Version>         Changes the default install version for new distributions.     --shutdown         Immediately terminates all running distributions and the WSL 2         lightweight utility virtual machine.     --status         Show the status of Windows Subsystem for Linux.     --unmount [Disk]         Unmounts and detaches a disk from all WSL2 distributions.         Unmounts and detaches all disks if called without argument.     --update         Update the Windows Subsystem for Linux package.         Options:             --web-download                 Download the update from the internet instead of the Microsoft Store.             --pre-release                 Download a pre-release version if available. Implies --web-download.     --version, -v         Display version information. Arguments for managing distributions in Windows Subsystem for Linux:     --export <Distro> <FileName> [Options]         Exports the distribution to a tar file.         The filename can be - for standard output.         Options:             --vhd                 Specifies that the distribution should be exported as a .vhdx file.     --import <Distro> <InstallLocation> <FileName> [Options]         Imports the specified tar file as a new distribution.         The filename can be - for standard input.         Options:             --version <Version>                 Specifies the version to use for the new distribution.             --vhd                 Specifies that the provided file is a .vhdx file, not a tar file.                 This operation makes a copy of the .vhdx file at the specified install location.     --import-in-place <Distro> <FileName>         Imports the specified .vhdx file as a new distribution.         This virtual hard disk must be formatted with the ext4 filesystem type.     --list, -l [Options]         Lists distributions.         Options:             --all                 List all distributions, including distributions that are                 currently being installed or uninstalled.
            --running
 
                List only distributions that are currently running.
 
            --quiet, -q
 
                Only show distribution names.
 
            --verbose, -v
 
                Show detailed information about all distributions.
 
            --online, -o
 
                Displays a list of available distributions for install with 'wsl.exe --install'.
 
    --set-default, -s <Distro>
 
        Sets the distribution as the default.
 
    --set-version <Distro> <Version>
 
        Changes the version of the specified distribution.
 
    --terminate, -t <Distro>
 
        Terminates the specified distribution.
 
    --unregister <Distro>
 
        Unregisters the distribution and deletes the root filesystem.{{References}}
</pre>
{{References}}
 
[[Category:Linux]]
[[Category:Windows]]
[[Category:OS]]