# Peiso

> The Peios image builder — from a declarative peiso.toml to a composed root, packed initramfs, UKI, and bootable live ISO.

All of Peiso as one markdown file: [/peios/peiso/print.md](/peios/peiso/print.md)

## Building images

- [Building a Peios image](/peios/peiso/building-images/overview.md): peiso is the Peios image builder: it turns a declarative peiso.toml spec into a bootable image tree, layering boot machinery over a peipkg-compose root.
- [Quick start](/peios/peiso/building-images/quick-start.md): Run your first peiso build — a minimal peiso.toml that composes the package root and packs the initramfs, and what it leaves on disk.
- [The build pipeline](/peios/peiso/building-images/the-build-pipeline.md): Each stage of a peiso build in order, from compose to ISO — which stages run host tools, which run Peios applets in the chroot, and why the order matters.
- [Running a build](/peios/peiso/building-images/running-a-build.md): How to run peiso build: the one command and its spec argument, why it must run as root, its exit codes, the tools it needs, and the dist Makefile workflow.

## Reference

- [The build spec](/peios/peiso/reference/the-build-spec.md): Field-by-field reference for peiso.toml: every table and key with types, defaults and path handling, plus the exact validation rules peiso enforces.