LevitateOS

Documentation

Variants

LevitateOS is a shared build system with multiple OS variants. They share the recipe engine and tooling, but differ in base, init, and intended deployment.

Section

Variant Matrix

Variant Goal Base Init Primary Artifact Mutable?
LevitateOS Daily-driver desktop/workstation Rocky RPM extraction (glibc) systemd ISO (installer/live) Optional (unsafe)
AcornOS Daily-driver desktop/workstation (musl mirror) Alpine APK extraction (musl) OpenRC ISO (installer/live) Optional (unsafe)
RalphOS Agents-only automation appliance Levitate-based (glibc) profile systemd QCOW2 + raw .img No

NOTE

All variants are A/B immutable by default. Mutable mode (where it exists) is an explicit opt-in for daredevils, and is unsafe if you let an LLM author recipes without review. See Atomic Updates (A/B).

Section

RalphOS (High-Level)

RalphOS is not a user-interactive desktop OS. It is an agents-only host designed to run an orchestration control plane (ralphd) and isolated sandboxes with tight security defaults.

  • Immutable-only: A/B slots, trial boot, commit/rollback
  • Provision-first: initial access via injected SSH key
  • Disk images first: qcow2 for VMs, raw .img for bare metal

RalphOS details live alongside the repo in the RalphOS planning notes (pre-release).

Section

Where To Start