Peios Learn
Peios is an operating system designed for secure, manageable infrastructure. Learn how it works — from the security model and identity system to service management, federation, and beyond.
Documentation
Peios
The Peios operating system from an operator's perspective — identity, access control, services, and the surfaces you work with running Peios in production.
255 articlesPeios Packages
Building, distributing, and serving software packages for Peios — recipes, the build farm, and the official repository.
21 articlesTrail
Static site generator for documentation with pathway support, fuzzy search, and dark mode.
20 articlesProvium
General-purpose KVM test harness for kernel and system code. Write tests in Lua, run them against real VMs.
37 articlesPeios SDK
Build software that talks to Peios. The SDK is the C-ABI library family for the kernel↔userspace boundary — access control, the registry, and events — starting with libpeios. Link it from C, or from anything that speaks the C ABI.
31 articlesPeiso
The Peios image builder — the tool that cuts a release into a bootable artifact. peiso composes a package root with peipkg-compose, then layers the initramfs, sysroot, UKI, and live ISO on top, all driven by a declarative peiso.toml spec.
5 articlesPekit
The recipe-driven build and packaging tool for Peios. Pekit reads declarative recipes, resolves sources and versions, plans the work before touching anything, then builds, tests, installs, packages, and publishes — one recipe or a whole workspace at a time. It is the tool that turns source into .peipkg files.
15 articlesSpecifications
Peios Specification Documents
Peios Specification Documents — conventions for writing, numbering, versioning, and citing Peios specifications.
v0.20 21 sections psd-002Binary Identifiers
Binary identifier types — GUID and LUID formats, comparison, generation, and allocation.
v0.20 11 sections psd-003KMES
Kernel Mediated Event Subsystem — unified event emission, buffering, and delivery for the Peios kernel.
v0.20 13 sections psd-004KACS
Kernel Access Control Subsystem — tokens, security descriptors, access checks, and integrity controls.
v0.20 69 sections psd-005LCS
Layered Configuration Subsystem — kernel-mediated hierarchical configuration store with layers, watches, and transactions.
v0.21 31 sections psd-006Loregd
Local Registry Daemon — SQLite-backed RSI source providing the Machine and Users hives.
v0.21 8 sections psd-007Peinit
Peios init system — PID 1 service manager with KACS-integrated identity, dependency ordering, and supervised process execution.
v0.22 30 sections psd-008eventd
Event daemon — unified observability sink and query engine for events, logs, and metrics.
v0.23 44 sections psd-009Peipkg
Peios package format and repository protocol — binary distribution primitive, signing, and repo conventions.
v0.22 36 sections psd-010authd
Authentication subsystem — the authd authentication broker, the lpsd local principal store, logon, credential verification, token minting, and the source-transparent client protocol.
v0.23 25 sections