DevuanWSL

Warning

While automated releases are still available, I no longer actively use WSL. This means tarballs are provided AS IS and it may break at any time (which is very unlikely though).

Devuan Linux on WSL2 based on DevuanWSL, powered by wsldl.

This fork is based on Daedalus (current stable) in favor of the original Beowulf.

Requirements

• Windows 10 1803 April 2018 Update x64 or later.
• Windows Subsystem for Linux feature is enabled.
• Latest WSL recommended.

Install

1. Download installer zip from release or monthly action build (recommended)
2. Extract all files in zip file to same directory (e.g. C:\WSL\Devuan)
3. Run Devuan.exe to Extract rootfs and Register to WSL

Exe filename is using to the instance name to register. If you rename it, you can register with a different name and have multiple installs.

How-to-Use (for Installed Instance)

Usage

Usage :
    <no args>
      - Open a new shell with your default settings.

    run <command line>
      - Run the given command line in that distro. Inherit current directory.

    runp <command line (includes windows path)>
      - Run the path translated command line in that distro.

    config [setting [value]]
      - `--default-user <user>`: Set the default user for this distro to <user>
      - `--default-uid <uid>`: Set the default user uid for this distro to <uid>
      - `--append-path <on|off>`: Switch of Append Windows PATH to $PATH
      - `--mount-drive <on|off>`: Switch of Mount drives
      - `--default-term <default|wt|flute>`: Set default terminal window

    get [setting]
      - `--default-uid`: Get the default user uid in this distro
      - `--append-path`: Get on/off status of Append Windows PATH to $PATH
      - `--mount-drive`: Get on/off status of Mount drives
      - `--wsl-version`: Get WSL Version 1/2 for this distro
      - `--default-term`: Get Default Terminal for this distro launcher
      - `--lxguid`: Get WSL GUID key for this distro

    backup [contents]
      - `--tgz`: Output backup.tar.gz to the current directory using tar command
      - `--reg`: Output settings registry file to the current directory

    clean
      - Uninstall the distro.

    help
      - Print this usage message.

Uninstall

.\Devuan.exe clean

How-to-Build

DevuanWSL can be built on GNU/Linux or WSL.

curl, bsdtar, jq and unzip is required for build.

# Install build tools
sudo apt install -y curl libarchive-tools jq unzip
# Make release
# Use of `sudo` recommended to avoid weird file permission in rootfs
sudo make
# Clean-up using `sudo` as some files are owned by root
sudo make clean

TODO

• Add CI (GitHub Actions)
• Support new .wsl format (unreleased)
• Write a WebHook to automatically fetch Atom feed of the upstream build & trigger CI (not interested as we have action releases)