slawak / one-script-wsl2-systemd

The one-script variant of the systemd hack for WSL2

About

This repository includes the files to set-up WSL2 distro to run systemd.

What does it do

In WSL2

• Install a script that starts systemd inside a process namespace so that it gets PID 1.
• Install a sudoers configuration file that allows the script to call itself as root without requring setuid.
• Install GPG and SSH agent relays to Windows equivalents.
• Install WSLUtilities
• Configure your WSL sessions to connect to an X11 server in Windows.
• Configure xdg-open to open files and addresses in Windows

In Windows

• Install GPG4Win via winget.exe, which is available in the latest dev branch of Windows 10 Insider Preview.
• Add a scheduled task that launches when you login to Windows to start the GPG-Agent from GPG4Win
• Install a custom WSL kernel based on the Microsoft sources with AppArmor added to support Snap Package strict confinement.
• Add a scheduled task that launches when you login to Windows to update the custom kernel when a new release is made.
• Enable and start the in-built Windows SSH-Agent service.

Installing

1. Download the install.ps1 script
2. Open a PowerShell or CMD window: press Win + x then choose either "Command Prompt" or "Windows PowerShell" depending on which your system presents in the menu
3. Run the following command in the PowerShell or CMD window to set up your default distro

   powershell.exe -NonInteractive -NoProfile -ExecutionPolicy Bypass -File \path\to\install.ps1

You can also specify a distro name with the -distro Ubuntu-20.04 flag:

powershell.exe -NonInteractive -NoProfile -ExecutionPolicy Bypass -File \path\to\install.ps1 -distro Ubuntu-20.04

Alternatives

• Damion Gans' installer for the two-script variant
• My 'change the user shell' variant that supports zsh and fish