# ArchWSL

**Repository Path**: bdjlsk/ArchWSL

## Basic Information

- **Project Name**: ArchWSL
- **Description**: ArchLinux as a WSL Instance. Supports multiple install.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-02
- **Last Updated**: 2020-12-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ArchWSL
ArchLinux on WSL (Windows 10 FCU or later)
based on [wsldl](https://github.com/yuk7/wsldl)


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

[![Travis (.org)](https://img.shields.io/travis/yuk7/ArchWSL.svg?logo=data%3Aimage%2Fpng%3Bbase64%2CiVBORw0KGgoAAAANSUhEUgAAADAAAAAwCAYAAABXAvmHAAABEWlDQ1BTa2lhAAAokYWRoU7DUBSGPwqGhAQEYgJxBQIDAZYQBGqIBlu2ZODarhSStWtuu4wXIBgMBk14CHgFPAEDD4EgaP6uojUb%2F82558vJyb33PxecFpKzBklaWM%2FtmP7ZuaEhP8wzZmsBfj%2FKHd625%2FTN0vIgykPlb0VhdbmOHIjX44qvSw4qvivZdr1j8aN4K25w0OBJkRXi17I%2FzGzJX%2BKjZDgO63ezEqW9U%2BW%2BYoN9dhSGLhaflJwLIrFhwhUFl6IcD5eOyFVPwlj1f1TPc6S3Hf7A4n1dCx7g5RZan3Vt8wlWb%2BD5PfOtPy0tKZx2u5rzvDvqv5jh1Uy9uoy0YoZyaDiR21DujfzvssfBH0tmRP2ZPyMqAAAABHNCSVQICAgIfAhkiAAAAzpJREFUaIHtmc9qFFkUxn%2F3VnWHmMSgouMYJepIEFFxMQPjA7h3JcwT%2BAyzm93gE%2BhCdOufhUuRwTdwIXGhwZlEF4ITRzSKSaeq7jmzuFXVf5Ku6lZJ30B%2F0HTRnOKer873nXNvF4wxxhhjjPENMMXFym2OJ3FjduA7V1NYrQ979OoE75I9lTFJvPHq2v3ltYHX7oAB%2BPsWx1yzsQImGurmpQRcdYxTw72XZ3BqqsK%2BpJLN%2F%2Fngxfth1geIATZpzlghWjhqUB38ZmMj7L81DFB%2Bba3z8uOBvhHvP29OaRRdAu4MvrqHLZcREAcig3%2FcvsEKdmr2A1XPZaJhMaJXhk0e8gqQJEizgat7mL0wkM7F2C9SGXZoZp0zcX91bGbCf5%2FSS4s3G1eNoVJroMtnZ7LH5ooXb1z8LOKrMISC%2FH3TFqZtZUwEXDzypn9KCqsfdDpz3KhbbzM1PFtrLKqmF4xBcw%2FQiB3DV%2BA74uBszYPvwD9v9PyT6ywAS2UFXO6BEsO4eSdhQBRiZRJKD4BaLQk0fpxn8qdzUCfHEWHi6WtaS4sKabcHxAGq7Dn98wjTq0d84DD7Lx6y8NATSFMwdrQeGAbGQMv6obvVA0q4%2Bi%2BgCpm%2FjAGSFKLcAxp68j1oV8CREyAfBgET6Uit7EISeRJaJB9w%2Fj453yG9iQHTVYGgs%2Ff5pd4EvgIpiAWXlfoJm8QWCZHvRDsrsJsIJEk%2BB7Kii4ZNQDsYlBJy8W6qQC8BQEXzLqS7gIDQ1YXWU4hjkCzPWwInID1dKHMYayArtxJfcbLZSfRKyDpiMflWQvAMQ2bQr426jLb%2BQ5aQts%2Fg7UEWdXqg%2BpA%2BcohCus1WwnW0UZVAK2AodA50zgGrZQVUJFwJafeWv2yjzRiyrAiS3MiBQtTLhq5Bln8r4AI3sfRsp7cg%2BAoUA6sfARewB2D7OdAFkbDPxtL%2BG3FbAkF3IfAKydGnAi5sD6hC5ttQhQd2MqMhIbUVCLgLGfIuVFOBYE1s%2FOGreDfnCSipAh83vLzevmthq99ZjAyqIJnTiaZdg3yc%2FQH25G%2F8robjKrT2%2FjAlp3%2BZm8QQHA0LzExFf81dfn531Ll8F%2FwPo73Ufbbb6f8AAAAASUVORK5CYII%3D&style=flat-square)](https://travis-ci.org/yuk7/ArchWSL)
[![AppVeyor](https://img.shields.io/appveyor/ci/yuk7/ArchWSL.svg?logo=Windows&style=flat-square)](https://ci.appveyor.com/project/yuk7/archwsl)
[![Travis (.org)](https://img.shields.io/travis/yuk7/ArchWSL-FS.svg?logo=Linux&style=flat-square)](https://travis-ci.org/yuk7/ArchWSL-FS)
[![Github All Releases](https://img.shields.io/github/downloads/yuk7/ArchWSL/total.svg?style=flat-square)](https://github.com/yuk7/ArchWSL/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/ArchWSL.svg?style=flat-square)

[日本語](https://github.com/yuk7/ArchWSL/blob/master/README.ja.md)

### [⬇Download](https://github.com/yuk7/ArchWSL/releases/latest) | [📓Wiki](https://github.com/yuk7/ArchWSL/wiki)

## 💻Requirements
* Windows 10 1709 Fall Creators Update 64bit or later.
* Windows Subsystem for Linux feature is enabled.

## 💾Install
**[For details, please refer to the wiki](https://github.com/yuk7/ArchWSL/wiki/How-to-Setup)**
### 📁zip
#### 1. [Download](https://github.com/yuk7/ArchWSL/releases/latest) installer zip

#### 2. Extract all files in zip file to same directory
Please extract to a folder that has full access permission.
For example 'Program Files' can not be used.

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


### 📦appx
#### 1. [Download](https://github.com/yuk7/ArchWSL/releases/latest) installer .appx and .cer
#### 2. Install .cer to "Trusted Root Certification Authorities" of the local machine
[For details, please refer to the wiki](https://github.com/yuk7/ArchWSL/wiki/Install-Certificate)

You need administrator privileges to install the certificate
#### 3. Install .appx

## 📝How-to-Use(for Installed Instance)
#### exe Usage
```dos
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.
```

## ⬆️Update
### 📁zip
#### 1. [Download](https://github.com/yuk7/ArchWSL/releases/latest) installer zip
#### 2. Extract .exe and rootfs.tar.gz from .zip and overwrites existing ones.

### 📦appx
#### 1. [Download](https://github.com/yuk7/ArchWSL/releases/latest) installer .appx
#### 2.Overwrite install .appx

## 🚫Known issues
Please see [Wiki](https://github.com/yuk7/ArchWSL/wiki).