Arch-WSL icon indicating copy to clipboard operation
Arch-WSL copied to clipboard

This is an unofficial Arch WSL based on the rootfs of arch docker images with a few packages installed to make things easy.

Logo

Arch WSL

This is an unofficial Arch WSL based on the rootfs of arch docker images with a few packages installed to make your life easy
Explore the docs »

Download · Report Bug · Request Feature

Screenshot 2023-01-21 121103

Installation

  • Make sure WSL is enabled in you system - https://learn.microsoft.com/en-us/windows/wsl/install

  • You can install Arch WSL from Microsoft Store OR if you don't want to use Microsoft Store then download the latest msix package from Release Page

Note - to install manually from the msix package you need to install the .cer file first to the "Trusted Root Certificate Store" of the "local machine"

  • After installation is complete from microsoft store or manual install when you open the app you will be presented with a screen to create a user account go ahead with it and complete the account creation to finish installation

image

Note - The password entering feild does not display your password but it still records it

Build

Prerequisites

  • Visual Studio 2022
  • Python

Getting Started

  • Fork and clone your fork of the Project

  • Generate a test certificate:

    • In Visual Studio, open ArchWSL-Appx/MyDistro.appxmanifest
    • Select the Packaging tab
    • Select "Choose Certificate"
    • Click the Configure Certificate drop-down and select Create test certificate.
  • Copy tar.gz containing your distro into the x64 folder at the root of the project and rename it to rootfs.tar.gz

Note - You can get the rootfs.tar.gz file from the releases page

  • Then open a terminal window in the root of the project and type in the command
python build.py --target=build --config=debug --platform=x64

https://user-images.githubusercontent.com/52851879/211007722-3743c1a9-62a4-474c-b1be-f31c2ec4e25a.mov

Root FS

  • The main Root FS file this app is based on is at - https://github.com/VSWSL/Arch-WSL-RootFS

  • It is based on Arch Docker Image with few tweaks and pre-installed dependencies