Astromesh OS (Appliance)
Astromesh OS is a minimal, immutable, API-only Linux appliance that exists for one purpose: running Astromesh agents. It is built with mkosi on Debian, ships a verified read-only root (dm-verity), updates via A/B slots with automatic rollback, and bakes the runtime in at a pinned commit — no shell, no SSH, no package manager at runtime.
👉 Full documentation has moved to its own section: Astromesh OS. Source: github.com/monaccode/astromesh-os (v0.4.0, mature through Phase 4 + post-4).
- Introduction — what the appliance is and why
- Architecture — immutability, A/B updates, UKI, security, fleet, the 500 MB ceiling
- Operations & Commands — pull, boot, health-check, A/B update, and
astromeshctl - Building the Image — mkosi, the WSL2 + KVM dev loop, and CI
- Phases & Roadmap — the gated path from Phase 0 to fleet
Not what you were looking for?
Section titled “Not what you were looking for?”Astromesh OS is a self-contained appliance image. If instead you want to install the runtime as a system service on an existing Linux, macOS, or Windows machine (via .deb / .rpm / installer), you want Astromesh Node — the cross-platform installer and daemon. See The Ecosystem for how the two differ.