Documentation
Wiki.
Plain-language docs for using Margine day to day. If you came from a "traditional" Linux distro (Ubuntu, Mint, Arch, …), some of the habits change — Margine is built on the immutable / atomic model, so things like sudo apt install … aren't the right answer here. Each topic below explains what you do instead, in the simplest words.
Start here
What is Margine?
Immutable / atomic OS in plain language
Why Margine?
How Margine compares to Bluefin, Bluefin DX, and Bazzite (with love for all three)
Install status
ISO first since 2026-06-11 (Titanoboa live); rebase stays supported
Install from the ISO
Boot the live desktop, enroll the key, install — every step, with screenshots
Daily use
Install & remove apps
Bazaar (GUI) first; CLI as power-user fallback
Your home folder
3 top-level dirs — data, dev, scratch — and where Margine puts what
Pro workflows
DaVinci Resolve, BricsCAD, pro audio, ML / GPU compute — concrete recipes
Gaming
Steam, controllers, gamescope — the opt-in gaming layer
AI & local LLMs
Run a local LLM with Alpaca — opt-in, sandboxed, fully offline
Updates & rollback
It just works — but here's what happens behind the scenes
Tune your desktop
Keybinds, dock, extensions, default apps
Performance & tuning
Kernel performance
What we measured, why it's a fair test, and what the numbers mean in real use
CPU schedulers
sched_ext: swap the scheduler live — scx_lavd for gaming, scx_bpfland for busy desktops, Off for BORE
Scroll speed & gestures
GNOME has no scroll-speed slider — Margine ships wsf. One factor, set once, done
Audio & EasyEffects
System-wide audio effects, preinstalled — presets, per-device autoload, laptop-speaker rescue
Help
Want to know how Margine is actually built — kernel signing, Secure Boot, CI, ISOs, the whole pipeline? Read the atomic distro handbook. The deep architecture docs (ADRs, postmortems) live in the margine-fedora-atomic repo docs/ directory.