Volatoo is a Gentoo-based distribution with immutable system generations, a verified read-only lower stack, and a disposable tmpfs writable root.
| Repository | Responsibility |
|---|---|
| Volatoo | Distribution integration, initramfs, persistence, image construction, update client, and implementation-local architecture contracts |
| volatoo-overlay | Official Gentoo ebuild repository and Volatoo profiles |
| installer | Interactive and unattended installation, explicit disk plans, and installation receipts |
| kernel | Kernel configurations, patch series, packaging metadata, and boot compatibility |
| Repository | Responsibility |
|---|---|
| releng | Reproducible image definitions, release orchestration, promotion, and publication gates |
| keyring | Public verification keys, rotations, and revocations; never private keys |
| security-advisories | Volatoo-specific advisories and machine-readable vulnerability metadata |
| qa | Complete-system QEMU, hardware, upgrade, rollback, and release qualification |
| Repository | Responsibility |
|---|---|
| portage-engine | Independent binpkg build, verification, signing, and publishing service |
| website | Public website, user handbook, and release portal |
| infrastructure | Shared public-service infrastructure-as-code; never secrets or state |
| artwork | Canonical logos, brand guidelines, boot artwork, and wallpapers |
| rfcs | Cross-repository proposals, compatibility contracts, and accepted decisions |
| .github | Organization profile and shared community-health defaults |
Design documents stay with the implementation they version. Release images, packages, checksums, SBOMs, and signatures are published as artifacts rather than stored in Git repositories.
Start with the main project and its roadmap.