/KISSWSL

KISS Linux WSL

Primary LanguageMakefileMIT LicenseMIT

KISSWSL

KISS Linux WSL

KISS Linux on WSL (Windows 10 1803 or later) based on wsldl.

screenshot

Build Zip CI Github All Releases PRs Welcome License

Requirements

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

Install

1. Download installer zip

2. Extract all files in zip file to same directory

3.Run KISS.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 diffrent name and have multiple installs.

How-to-Use(for Installed Instance)

exe Usage

Usage :
    <no args>
      - Launches the distro's default behavior. By default, this launches your default shell.

    run <command line>
      - Run the given 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

    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
      - `--lxuid`: Get LxUID key for this distro

    clean
     - Uninstalls the distro.

    help
      - Print this usage message.

How to uninstall instance

> KISS.exe clean

How-to-Build

KISS WSL can build on GNU/Linux, WSL and macOS.

curl,zip,unzip,tar(gnu) and sudo is required for build.

$ make