Maze Linux / Wiki

Maze Repo on Arch Linux

Not running Maze? You can still use Maze's own applications (haze, qlam, maze-guard, entropy-shield, hazedrop and the rest) on a regular x86_64 Arch Linux install. Add the signed [mazelinux] repository with the strap.sh script.

Quick setup

curl -O https://mazelinux.berkkucukk.com.tr/strap.sh
curl -O https://mazelinux.berkkucukk.com.tr/strap.sh.sha256
sha256sum -c strap.sh.sha256
chmod +x strap.sh
sudo ./strap.sh

Then install whatever you want:

pacman -Sl mazelinux        # list every package in the repo
sudo pacman -S haze qlam    # install one or more

From then on, these packages update with a normal sudo pacman -Syu.

Read a script before you run it as root. strap.sh is short and has comments: less strap.sh.

What the script does

  1. Checks that the system is x86_64 Arch Linux with pacman, and that it is running as root.

  2. Initialises the pacman keyring if it has not been set up yet.

  3. Downloads the Maze signing key and refuses to continue unless its fingerprint matches the one built into the script: 7C4D 515A 6B93 0CB0 4794 CEF6 147C 8159 B3E2 EE5F

  4. Adds the key to the pacman keyring and signs it locally.

  5. Backs up /etc/pacman.conf (as pacman.conf.strap-<date>.bak) and adds the repository after the official Arch repos, so Arch packages always take priority:

    [mazelinux]
    SigLevel = Required DatabaseOptional
    Server = https://mazerepo.berkkucukk.com.tr/packages
    
  6. Syncs the databases and installs mazelinux-keyring, which keeps the key current from then on.

You can run it again safely. If the repository is already configured, it leaves pacman.conf untouched.

Packages to avoid on a plain Arch system

Most packages are standalone apps. A few exist to turn a system into Maze, and they change far more than a single application:

PackageWhat it changes
maze-metaPulls in the full Maze package set
maze-plasma-configReplaces your KDE Plasma layout, theme and settings
maze-brandingos-release, boot splash, logos
maze-hardeningKernel parameters, sysctl, service settings
maze-securebootThe signed-UKI Secure Boot chain

Install these only if you really want your system to become Maze.

Removing the repository

sudo ./strap.sh --remove

This removes the [mazelinux] section from pacman.conf (after making a backup), uninstalls mazelinux-keyring and deletes the key from the pacman keyring. Apps you already installed stay on the system. They show up in pacman -Qm and no longer get updates, so uninstall them with sudo pacman -Rns <package> if you no longer want them.

Troubleshooting

key fingerprint mismatch: the downloaded key is not the Maze key. The script stops without changing anything. Do not import the key by hand. Open an issue instead.

pacman is running: another pacman process holds the lock. Wait for it to finish. If no pacman is running, delete the stale lock with sudo rm /var/lib/pacman/db.lck.

signature is unknown trust / invalid or corrupted package: the keyring is out of date. Run sudo pacman -Sy mazelinux-keyring, or run sudo ./strap.sh again.