Manual
-
If WSL is not installed, install it from an administrator
cmdor PowerShell withwsl --install. See the Microsoft docs. -
Install Ubuntu 26.04 or 24.04. From PowerShell (as Administrator):
wsl.exe --list --online # shows the exact distribution nameswsl.exe --install -d Ubuntu-26.04 # or Ubuntu-24.04wsl.exe --set-default Ubuntu-26.04 -
Check that
systemdruns in the distribution:systemctl is-system-runningshould printrunningordegraded. New Ubuntu installs enable it by default. If it does not, add these lines to/etc/wsl.conf:[boot]systemd=trueThen restart WSL from Windows with
wsl --shutdown. See systemd support in WSL. -
(optional) Install a Nerd Font. The FiraCode Nerd Font I use is in
ansible/roles/windows/files/fonts; the latest FiraCode release has all variants. -
(optional) Install Windows Terminal and set the font of its Ubuntu profile to the Nerd Font (Settings → Ubuntu → Appearance → Font face).
ansible/roles/windows/templates/settings.json.j2has my settings for reference.
Any terminal and any Nerd Font work; steps 4 and 5 are only my suggestion. Fonts differ in how many icons they include, and FiraCode has a lot. Without a Nerd Font, turn the icons off with nerd_fonts: false.
Then continue with Installation.