HyperbolaWSL-FS

RootFS builder for Hyperbola GNU/Linux-libre on WSL 2.

Español

Quick Start

make

This generates rootfs.tar.gz.

Installation on Windows

wsl --import Hyperbola .\Hyperbola\ rootfs.tar.gz
wsl -d Hyperbola

The pacman keyring is pre-initialized during the build, ready to use on first boot.

Build pipeline

1. Download Hyperbola bootstrap + additional packages (glibc, fakeroot, keyring)
2. Extract into root.x86_64/ with device nodes and tune pacman config for chroot
3. Install hyperbola-keyring and initialize pacman keyring
4. Install base packages via pacman (with signature verification)
5. Install pinned versions (glibc, fakeroot) over the repo versions
6. Configure locales, mirrorlist and wsl.conf
7. Clean up, restore pacman.conf and package → rootfs.tar.gz

CI

Forgejo Actions builds the rootfs automatically on every tag push and uploads it as a release artifact.

Requirements

• sudo, tar, curl
• GNU/Linux host (or WSL 2 with a distro that has the required tools)

License

HyperbolaWSL-FS is fully free software: everything here respects your freedom.

Licensed under the GNU General Public License v3.0 — Free as in Freedom.