Skip to main content
Version: stable

Manual

  1. If you don't have WSL installed, you need to install it with: wsl --install executed from administrative cmd or powershell terminal. See windows docs

  2. Install Ubuntu 22.04, execute from Powershell (Administrator):

    wsl.exe --install -d 'Ubuntu-22.04'
    wsl.exe --set-default 'Ubuntu-22.04'

    For details, see Microsoft WSL installation docs

  3. Enable systemd in your distribution: Add these lines to /etc/wsl.conf:

    [boot]
    systemd=true

    Then restart WSL from Windows cmd: wsl --shutdown. After next login it should have systemd configured. For more information see windows docs for systemd

  4. (optionally) Install FiraCode nerd fonts (the ones I use are in ansible/roles/windows/files/fonts, if you need, download all FiraCode Nerd fonts and use whichever you want)

  5. (optionally) Install Microsoft Terminal and configure this Terminals Ubuntu profile with FiraCode NF nerd font (Settings -> Ubuntu-22.04 -> Appearance -> Font Face). You can check ansible/roles/windows/templates/settings.json.j2 for settings reference with useful overrides.

In points #3 and #4 specific font+terminal duo is just a suggestion (I use them personally) - you can use any terminal of your choice and any font supporting iconic fonts (like Nerd Fonts - please note that not all fonts have the same amount of glyphs/icons. FiraCode has lots of them. Remember to configure you terminal to use your font!

Thats it, you can move to Installation