Skip to content
master
Switch branches/tags
Go to file
Code

README.md

ArchWSL

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

screenshot

Build status zip AppVeyor Travis (.org) Github All Releases PRs Welcome License

日本語 | 简体中文 | 繁體中文

Download | 📓Docs

💻Requirements

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

💾Install

For details, please refer to the docs

📁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 Certification Authorities" of the local machine

For details, please refer to the docs

You need administrator privileges to install the certificate

3. Install .appx

🥄 Scoop

scoop bucket add extras

scoop install archwsl

📝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]
      - `--tar`: Output backup.tar to the current directory
      - `--reg`: Output settings registry file to the current directory

    clean
      - Uninstall 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 docs.