Documentation

Install status

As of June 11, 2026, the primary install path is the Margine live ISO: it boots a full GNOME live session with Margine already baked in, and installs from there with the graphical installer. The ISO pipeline moved to Universal Blue's Titanoboa builder and was validated end to end in a VM. Rebasing from Bluefin DX remains fully supported as the alternative.

Primary today: the live ISO

Download the latest ISO from the home page, write it to a USB stick, boot it — you land in a complete Margine desktop you can try without touching the disk — and start the installer when ready. Step-by-step walkthrough with screenshots: Install from the ISO.

The cutover decision and its validation are documented in ADR 0008 (Titanoboa migration): the live session, the installer, and the installed system's first boot all passed in a VM on 2026-06-11. Hardware-specific validation (Secure Boot MOK enrollment, TPM2 auto-unlock) continues — if you hit something odd on metal, please report it with the dated ISO identifier.

Alternative: rebase from Bluefin DX

Still fully supported, and handy if you already run a Fedora Atomic system: install Bluefin DX with its installer, boot it once, then run:

rpm-ostree rebase \
  ostree-image-signed:docker://\
  ghcr.io/daniel-g-carrasco/margine:stable
systemctl reboot

After the first Margine boot, enroll the Margine MOK and run ujust margine-bootstrap.

What changed under the hood

The previous ISO was a plain Anaconda installer image built with bootc-image-builder. The new one is built with Titanoboa, Universal Blue's live-ISO builder (the same tool behind Bazzite and Bluefin ISOs): the OCI image you would install becomes a bootable live session, so what you try is literally what you get. Releases are published to the Internet Archive as margine-live-iso-YYYYMMDD (older ones remain under margine-anaconda-iso-*).