Documentation
Variants
LevitateOS and AcornOS are two independent operating systems built by one pipeline. They share the recipe engine, the build pipeline and the install tools, but differ in the packages their userland is built from, libc, init, administrator tool, desktop and kernel line.
Variant Matrix
| Variant | Goal | Userland built from | Stack | Admin | Desktop | Kernel |
|---|---|---|---|---|---|---|
| AcornOS | Small, strict system: the fewest parts that do the job | Alpine 3.24 APK packages | musl / OpenRC / busybox | doas | LXQt on X11 (XLibre) | 6.18.63 (long-term support) |
| LevitateOS | Daily-driver workstation, maximum compatibility | Fedora 45 RPM packages, signed and locked | glibc / systemd / GNU | sudo | KDE Plasma on Wayland | 7.3.4 (latest stable) |
Note
Both variants use A/B by default.
recab manages the two roots: the booted root is locked and changes are made in the other root. Mutable mode is an explicit opt-in. See A/B Roots.One Pipeline
distro-builder builds both from their own contract, distro/variants/<distro>/distro.toml (with the kernel configuration kconfig and the release hooks beside it): what each variant declares for sources, products and the live system. The install screen is the same on both (distro/contract/src/install_ux.rs). Recipes own the package facts; the builder owns orchestration and output locations.
Where To Start
- Install → Getting Started
- Packages → recipe CLI Reference
- A/B roots → A/B Roots
- Build/test loop →
cargo xtask --help, andarchitecture.md(repo root) for where each fact lives