User Tools

Site Tools


windows_subsystem_for_linux_setup

Windows Subsystem for Linux (WSL)

I'll grudgingly admit that Windows Subsytem for Linux isn't bad like I thought it would be. That said, there are several things you might want to do to make it more livable.

Enabling WSL

First, to enable WSL at all, in adminstrator powershell:

wsl --install

Then, it still being Windows, you have to restart. If it hangs or is weird, restart and try again. If it is then weird in a new way, restart, and try again.

Installing distro

To get Ubuntu 24.04:

wsl --install ubuntu-24.04

To see other distros:

wsl --list --online

Making it Launchy-launchable

The distro will be installed as an "app", which is Windows 10 speak for "dumbed down program that's treated in special ways that break normal workflows". If you have classic Start and Launchy, to make it work with Launchy:

  • Make a shortcut of the "app", then put the shortcut into the classic start menu programs list.

Update plus basic packages

The default package set is actually not bad. But this will update and install what's missing:

sudo apt update
sudo apt dist-upgrade
sudo apt install lynx links binutils zip unzip gdb build-essential dos2unix

Bigger list:

sudo apt install at bc bzip2 default-jdk dos2unix fdisk ffmpeg build-essential gdb hashdeep valgrind lynx links wget curl ltrace strace manpages-dev mdadm nasm net-tools netcat nmap pv spim zip unzip whois x11-apps

To get to places easily:

ln -s /mnt/c/Users/$USER ~

"Open Linux Shell Here" context menu

It turns out there already is one by default, but it only shows if you shift right click. To make it always visible (per here):

  • Download and run "ExecTI" to allow you to run regedit as TrustedInstaller (more privileges than admin)
  • Run regedit using the tool
  • In HKEY_CLASSES_ROOT\Directory\shell\WSL, delete the key Extended

Run explorer from this directory in bash

I'm used to saying start . to open an explorer in this directory. Using this recipe, you can add the following to ~/.bashrc to restore this functionality:

alias start="powershell.exe /c start"

Keyboard scrolling

By default, there's no keyboard shortcut to scroll the Windows terminal. Per here, a quick duct tape solution is to use the following script in AutoHotKey:

#IfWinActive ahk_class ConsoleWindowClass

+PgUp::
Send {WheelUp}
Return

+PgDn::
Send {WheelDown}
Return

#IfWinActive

Ensure Windows drives are writable

I just upgraded to Ubuntu 22.04 WSL, and found that some IO requests to /mnt/c were getting permission denied. Upon investigating, I found that the old WSL (which worked) had this output for mount:

C:\ on /mnt/c type drvfs (rw,noatime,uid=1000,gid=1000,case=off)

And the new one had:

C:\ on /mnt/c type drvfs (rw,noatime,uid=0,gid=0,case=off)

The fix is to set UID for the WSL mounts. This can be done by editing /etc/wsl.conf and adding:

[automount]
options = "uid=1000,gid=1000"

Script to mount *all* drives

By default, WSL just mounts physical drives around at boot. This script mounts all drives Windows knows about to directories under /mnt:

for DRV in `wmic.exe logicaldisk get name | grep : | awk '{print tolower($1)}'` ; do
    MNT=/mnt/${DRV::1}
    if mount | grep -q $MNT ; then
        echo $MNT already mounted
    else
        sudo mkdir -p $MNT
        sudo mount -t drvfs $DRV $MNT
    fi
done
windows_subsystem_for_linux_setup.txt · Last modified: 2024/12/22 19:54 by tkbletsc

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki