WSL Distribution Launcher alternative. Use any rootfs. (Win10 FCU 64bit or later.)
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
res res/: add Void Linux icon and rc for exe Dec 26, 2018
.travis.yml native: convert to plain C99 Dec 26, 2018
LICENSE add MIT license file Nov 21, 2017 rename project to 'wsldl' Aug 8, 2018 Update auther info Jan 1, 2019
main.c native: convert to plain C99 Dec 26, 2018
version.h add version command Aug 8, 2018
wsld.h native: convert to plain C99 Dec 26, 2018


General Purpose WSL Distribution Installer & Launcher


Build Status Github All Releases PRs Welcome License


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

Install with prebuilt rootfs

1. Download installer zip

Alpine Linux

Alpine Linux with Git-LFS and Sphinx (by binarylandscapes)

Arch Linux

Artix Linux (by hdk5)

CentOS (by fbigun)

Void Linux (glibc) (by am11)

Void Linux (musl-libc) (by am11)

2. Extract all files in zip file to same directory

3.Run 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.

Install with any rootfs

1. Download Launcher.exe

2. Rename it for distribution name to register.

(Ex:Rename to Arch.exe if you want to use "Arch" for the Instance name)

3. Put your rootfs.tar.gz in same directory as exe (Installation directory)

4. Run exe to install. This process may take a few minutes.

How-to-Use(for Installed Instance)

exe 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.

    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

      - Uninstall the distro.

      - Print this usage message.

Just Run exe

[root@PC-NAME user]#

Run with command line

>{InstanceName}.exe run uname -r

Change Default User(id command required)

>{InstanceName}.exe config --default-user user

[user@PC-NAME dir]$

How to uninstall instance

>{InstanceName}.exe clean



Install x86_64 version of MSYS2(

Run these commands in msys shell

$ pacman -S mingw-w64-x86_64-toolchain # install tool chain
$ gcc -std=c99 --static main.cpp -o Launcher.exe # compile main.c

Optionally, to add an icon to the exe, create and link a resource with

$ windres res/Arch/res.rc res.o # compile resource
$ gcc -std=c99 --static main.cpp -o Launcher.exe res.o # compile main.cpp

Linux (cross compile)

Install mingw-w64 toolchain include g++-mingw-w64-x86-64.

Run this command in shell

 $ x86_64-w64-mingw32-gcc -std=c99 --static main.cpp -o Launcher.exe # compile main.cpp