/ArchWSL

ArchLinux as a WSL Instance. Supports multiple install.

Primary LanguageShellMIT LicenseMIT

ArchWSL

ArchLinux on WSL (Windows 10 FCU or later) based on wsldl

screenshot

Travis (.org) AppVeyor Travis (.org) Github All Releases Gitter PRs Welcome License

日本語

💻Requirements

  • Windows 10 1709 Fall Creators Update 64bit or later.
  • Windows Subsystem for Linux feature is enabled.

💾Install

📁zip

1. Download 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 installer .appx and .cer

2. Install .cer to "Trusted Root Certificate Store" of the local machine

For details, please refer to the wiki

You need administrator privileges to install the certificate

3. Install .appx

📝How-to-Use(for Installed Instance)

exe Usage

Useage :
    <no args>
      - Launches the distro's default behavior. By default, this launches your default shell.

    run <command line>
      - Run the given 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

    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
    backup
      - Execute the backup function using tar.

    clean
      - Uninstalls the distro.

    help
      - Print this usage message.

⬆️Update

📁zip

1. Download installer zip

2. Extract .exe and rootfs.tar.gz from .zip and overwrites existing ones.

📦appx

1. Download installer .appx

2.Overwrite install .appx

🚫Known issues

Please see Wiki.