Skip to content

Latest commit

 

History

History
67 lines (59 loc) · 2.4 KB

wsl.md

File metadata and controls

67 lines (59 loc) · 2.4 KB
Raw

Windows Subsytem for Linux (wsl)

WSL allows Windows users to run Linux (Unix) locally at a system-level. All of the standard tooling is used and community guides can be followed without standard Windows caveats (e.g., escaping file paths, GNU utilities missing, etc.)

  • Install from the Setup section
  • Enable
    • Start Menu > search for "Turn Windows Features On" > open > toggle "Windows Subsystem for Linux"
    • Restart
  • M1 Macs only (Intel Macs and native Windows boxes need not apply)
    • Revert WSL 2 to WSL 1 due to nested virtualization not being available at a hardware level 
      wsl --set-default-version 1
    • Docker won't run without paravirtualization enabled, but the rest of the development environment will work as expected
  • Install Ubuntu 
    # enable default distribution (Ubuntu)
wsl --install ubuntu
  • Start Linux and prep for environment setup 
    # launch Ubuntu
ubuntu

# upgrade packages (as root: `sudo -s`)
apt update && apt upgrade -y

# create standard user
adduser <username>
visudo

# search for 'Allow root to run any commands anywhere', then append identical line with new user
root            ALL=(ALL)       ALL
<username>      ALL=(ALL)       ALL

# Allow members of group sudo to execute any command
%sudo  ALL=(ALL) NOPASSWD: ALL
  • Additional configuration options
    • Configuration locations
      • WSL 1: /etc/wsl.conf
      • WSL 2: ~/.wslconfig 
          # set default user
  [user]
  default=<username>

  # mounts host drive at /mnt/c/ and retain permissions
  [automount]
  enabled = true
  options = "uid=1000,gid=1000,metadata"

  # WSL2-specific options
  [wsl2]
  memory = 8GB   # Limits VM memory in WSL 2
  processors = 6 # Makes the WSL 2 VM use two virtual processors
    • After making changes to the configuration file, WSL needs to be shutdown for 8 seconds
      • wsl --shutdown
    • OPTIONAL
    • Change home directory to host Windows' home
    # copy dotfiles to host home directory
cp -rfv $HOME/.* /mnt/c/Users/<username>

# edit /etc/passwd
<username>:x:1000:1000:,,,:/mnt/c/Users/<username>:/bin/bash