Skip to content
/ VoidWSL Public

Install Void Linux as a WSL Instance (for Windows 10 1803 64bit or later)


Notifications You must be signed in to change notification settings


Folders and files

Last commit message
Last commit date

Latest commit



58 Commits

Repository files navigation


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.


Main CI Workflow Github All Releases PRs Welcome License


  • Windows 10 1709 Fall Creators Update 64bit or later.
  • Windows Subsystem for Linux feature is enabled.


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

     - Uninstalls the distro.

      - Print this usage message.

How to uninstall instance

>Void.exe clean


VoidWSL can build on GNU/Linux or WSL.

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

$ make