Skip to content

Latest commit

 

History

History
71 lines (51 loc) · 2.4 KB

README.md

File metadata and controls

71 lines (51 loc) · 2.4 KB

VoidWSL

Void Linux on WSL (Windows 10 FCU or later) based on wsldl. This project hosts both the GNU-libc and musl-libc Void Linux variants.

screenshot

Main CI Workflow Github All Releases PRs Welcome License

Requirements

  • Windows 10 1709 Fall Creators Update 64bit 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 Void.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

>Void.exe clean

How-to-Build

VoidWSL can build on GNU/Linux or WSL.

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

$ make