Skip to main content
Version: stable

Manual

  1. If WSL is not installed, install it from an administrator cmd or PowerShell with wsl --install. See the Microsoft docs.

  2. Install Ubuntu 26.04 or 24.04. From PowerShell (as Administrator):

    wsl.exe --list --online # shows the exact distribution names
    wsl.exe --install -d Ubuntu-26.04 # or Ubuntu-24.04
    wsl.exe --set-default Ubuntu-26.04
  3. Check that systemd runs in the distribution: systemctl is-system-running should print running or degraded. New Ubuntu installs enable it by default. If it does not, add these lines to /etc/wsl.conf:

    [boot]
    systemd=true

    Then restart WSL from Windows with wsl --shutdown. See systemd support in WSL.

  4. (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.

  5. (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.j2 has 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.