https://github.com/yuk7/AlpineWSL
Alpine Linux based WSL distribution. Supports multi-install. Lightest WSL distribution.
https://github.com/yuk7/AlpineWSL
alpine-linux windows-10 windows-subsystem-linux wsl wsldl
Last synced: 7 months ago
JSON representation
Alpine Linux based WSL distribution. Supports multi-install. Lightest WSL distribution.
- Host: GitHub
- URL: https://github.com/yuk7/AlpineWSL
- Owner: yuk7
- License: mit
- Created: 2018-03-01T13:42:49.000Z (over 7 years ago)
- Default Branch: main
- Last Pushed: 2024-05-22T15:58:55.000Z (over 1 year ago)
- Last Synced: 2024-08-02T13:34:51.210Z (over 1 year ago)
- Topics: alpine-linux, windows-10, windows-subsystem-linux, wsl, wsldl
- Language: Makefile
- Homepage: https://git.io/alpwsl
- Size: 61.5 KB
- Stars: 522
- Watchers: 15
- Forks: 45
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- Awesome-WSL - AlpineWSL - Alpine in WSL. ![github project][githublogo] (Unofficial Distributions / 10. GUI Apps)
README
# AlpineWSL
Alpine Linux on WSL (Windows 10 1803 or later)
based on [wsldl](https://github.com/yuk7/wsldl)
[](https://github.com/yuk7/AlpineWSL/actions/workflows/build-zip.yaml)
[](https://github.com/yuk7/AlpineWSL/releases/latest)
[](http://makeapullrequest.com)
### [Download](https://github.com/yuk7/AlpineWSL/releases/latest)
## Requirements
* Windows 10 1803 April 2018 Update x64/arm64 or later.
* Windows Subsystem for Linux feature is enabled.
## Install
#### 1. [Download](https://github.com/yuk7/AlpineWSL/releases/latest) installer zip
#### 2. Extract all files in zip file to same directory
#### 3.Run Alpine.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 and have multiple installs.
## How-to-Use(for Installed Instance)
#### exe Usage
```dos
Usage :
- Open a new shell with your default settings.
run
- Run the given command line in that instance. Inherit current directory.
runp
- Run the given command line in that instance after converting its path.
config [setting [value]]
- `--default-user `: Set the default user of this instance to .
- `--default-uid `: Set the default user uid of this instance to .
- `--append-path `: Switch of Append Windows PATH to $PATH
- `--mount-drive `: Switch of Mount drives
- `--default-term `: Set default type of terminal window.
get [setting]
- `--default-uid`: Get the default user uid in this instance.
- `--append-path`: Get true/false status of Append Windows PATH to $PATH.
- `--mount-drive`: Get true/false status of Mount drives.
- `--wsl-version`: Get the version os the WSL (1/2) of this instance.
- `--default-term`: Get Default Terminal type of this instance launcher.
- `--lxguid`: Get WSL GUID key for this instance.
backup [contents]
- `--tar`: Output backup.tar to the current directory.
- `--reg`: Output settings registry file to the current directory.
clean
- Uninstall that instance.
help
- Print this usage message.
```
#### How to uninstall instance
```dos
>Alpine.exe clean
```
## How-to-Build
AlpineWSL can build on GNU/Linux or WSL.
`curl`,`bsdtar`,`tar`(gnu) and `sudo` is required for build.
```shell
$ make
```
with flags:
```
$ make ARCH=arm64 OUT_ZIP=Alpine_arm64.zip
```
### Basic Params
| Parameter | Value | Default |
| ---- | ---- | ---- |
| ARCH | x64/arm64 | x64 |
| LNCR_EXE | launcher file name | Alpine.exe |
| OUT_ZIP | zip file name | Alpine.zip |
| DLR | file downloader | curl |
| DLR_FLAGS | downloader flags | -L |
| BASE_URL | base rootfs url | https:~ |
| ROOTFS_TARBALL_CKSM_URL | sha-sum for the base rootfs tarball | https:~ |