Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/am11/VoidMuslWSL

Install Void Linux (with musl-libc) as a WSL Instance (for Windows 10 1803 64bit or later)
https://github.com/am11/VoidMuslWSL

musl-libc void-linux voidlinux wsl

Last synced: 3 months ago
JSON representation

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

Awesome Lists containing this project

README

        

### This repository is superseded by https://git.io/voidwsl, which provides both glibc and musl-libc variants.

# VoidMuslWSL
Void Linux on WSL (Windows 10 1803 or later) based on [wsldl](https://github.com/yuk7/wsldl).
This project is based on Void Linux musl-libc. For GNU-libc, visit https://git.io/voidwsl.

![screenshot](https://raw.githubusercontent.com/wiki/yuk7/wsldl/img/Arch_Alpine_Ubuntu.png)

[![Main CI Workflow](https://github.com/am11/VoidMuslWSL/actions/workflows/main.yml/badge.svg)](https://github.com/am11/VoidMuslWSL/actions/workflows/main.yml)
[![Github All Releases](https://img.shields.io/github/downloads/am11/VoidMuslWSL/total.svg?style=flat-square)](https://github.com/am11/VoidMuslWSL/releases/latest)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)
![License](https://img.shields.io/github/license/am11/VoidMuslWSL.svg?style=flat-square)

### [Download](https://github.com/am11/VoidMuslWSL/releases/latest)

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

## Install
#### 1. [Download](https://github.com/am11/VoidMuslWSL/releases/latest) installer zip

#### 2. Extract all files in zip file to same directory

#### 3.Run VoidMusl.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
```dos
Usage :

- Launches the distro's default behavior. By default, this launches your default shell.

run
- Run the given command line in that distro.

config [setting [value]]
- `--default-user `: Set the default user for this distro to
- `--default-uid `: Set the default user uid for this distro to
- `--append-path `: Switch of Append Windows PATH to $PATH
- `--mount-drive `: 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
```dos
>VoidMusl.exe clean

```

## How-to-Build
VoidMuslWSL can build on GNU/Linux or WSL.

`curl`,`zip`,`unzip`,`tar`(gnu) and `sudo` is required for build.
```shell
$ make
```