Docs: Variants

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

VariantGoalUserland built fromStackAdminDesktopKernel
AcornOSSmall, strict system: the fewest parts that do the jobAlpine 3.24 APK packagesmusl / OpenRC / busyboxdoasLXQt on X11 (XLibre)6.18.63 (long-term support)
LevitateOSDaily-driver workstation, maximum compatibilityFedora 45 RPM packages, signed and lockedglibc / systemd / GNUsudoKDE Plasma on Wayland7.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