Link Search Menu Expand Document

How to Set Up ArchWSL


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

Installation Instructions

There are two ways to install ArchWSL.

Method 1: zip file

  1. Download installer zip
  2. Extract all files in zip file to the same directory. Please extract to a folder that has write permission. For example, C:\Program Files cannot be used.
  3. Run Arch.exe to extract the rootfs and register to WSL

As a side note, the executable name is what is used as the WSL instance name. If you rename it, you can have multiple installs.

Method 2: appx pacakge

  1. Download the .appx and .cer
  2. Install .cer to the “Trusted Root Certificate Store” of the local machine. For details, please refer to the Install Certificate page. You will need administrator privileges to install the certificate.
  3. Install the .appx

Setup after install

Setting the root password

[root@PC-NAME user]# passwd

Set up the default user

Please see ArchWiki Sudo and User and groups pages.

[root@PC-NAME]# EDITOR=nano visudo
    %wheel      ALL=(ALL) ALL
    (setup sudoers file.)

[root@PC-NAME]# useradd -m -G wheel -s /bin/bash {username}
(add user)

[root@PC-NAME user]# passwd {username}
(set default user password)

[root@PC-NAME user]# exit

>Arch.exe config --default-user {username}
    (setting to default user)

If the default user has not been changed (issue #7), please reboot the computer or alternatively, restart the LxssManager in an Admin command prompt.

To restart the LxssManager, run this:

net stop lxssmanager && net start lxssmanager

Initialize keyring

Please excute these commands to initialize the keyring. (This step is necessary to use pacman.)

[user@PC-NAME]$ sudo pacman-key --init

[root@PC-NAME]$ sudo pacman-key --populate

Install systemctl alternative (Optional)

WSL does not have support for systemd however, there are several solutions. Please see Known issues.

Table of contents