mirror of
https://github.com/yuk7/AlpineWSL.git
synced 2026-01-19 00:57:21 +01:00
5e63e73cdd8f7f269cb961923ec59f276a7bb4ea
AlpineWSL
Alpine Linux on WSL (Windows 10 1803 or later) based on wsldl
Download
Requirements
- Windows 10 1803 April 2018 Update x64 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 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
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.
runp <command line (includes windows path)>
- Run the path translated 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
- `--default-term <default|wt|flute>`: Set default terminal window
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
- `--wsl-version`: Get WSL Version 1/2 for this distro
- `--default-term`: Get Default Terminal for this distro launcher
- `--lxguid`: Get WSL GUID key for this distro
backup [contents]
- `--tgz`: Output backup.tar.gz to the current directory using tar command
- `--reg`: Output settings registry file to the current directory
clean
- Uninstall the distro.
help
- Print this usage message.
How to uninstall instance
>Alpine.exe clean
How-to-Build
AlpineWSL can build on GNU/Linux or WSL.
curl,bsdtar,tar(gnu) and sudo is required for build.
$ 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:~ |
Languages
Makefile
91.7%
Shell
8.3%
