Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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: 2 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 (almost 7 years ago)
- Default Branch: main
- Last Pushed: 2024-05-22T15:58:55.000Z (8 months ago)
- Last Synced: 2024-08-02T13:34:51.210Z (6 months 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
README
# AlpineWSL
Alpine Linux on WSL (Windows 10 1803 or later)
based on [wsldl](https://github.com/yuk7/wsldl)![screenshot](https://raw.githubusercontent.com/wiki/yuk7/wsldl/img/Alpine_Arch_Cent.png)
[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/yuk7/AlpineWSL/build-zip.yaml?style=flat-square)](https://github.com/yuk7/AlpineWSL/actions/workflows/build-zip.yaml)
[![Github All Releases](https://img.shields.io/github/downloads/yuk7/AlpineWSL/total.svg?style=flat-square)](https://github.com/yuk7/AlpineWSL/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/yuk7/AlpineWSL.svg?style=flat-square)### [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:~ |