Documentation

Project documentation lives in the repository. These are the pages the site links to.

Installation

first-install.md — the first complete install, 2026-10-04, with the full transcript and screenshots.
guided-installer.md — the guided graphical installer: 10 pages, params schema, disk layout, archinstall API notes.
installer-iso.md — the live installer ISO: how it is built and verified.
testing.md — testing the installer: suites, counts, what is green.

Architecture

architecture.md — how the pieces fit.
pipeline.md — kryon-sync: the pipeline internals.
kernel.md — linux-kryon: the kernel packaging fork.
cloudflare-repo.md — the Kryon OS pacman repository: Worker + R2 design.
branding.md — layout and visual identity.

Reference

init-systems.md — replacing systemd after install.
environment.md — the host, and every gotcha.
bug-history.md — what went wrong and how it was fixed.

Z#

tutorial.md — read this first.
reference.md.
SAFETY-STATUS.md.
KNOWN-GAPS.md.
memory-model.md, layout.md, print-ABI.md.

The README

README.md is the single point of truth: current state, programs, kryon-sync, building the ISO, hardware notes, known limitations, and how to verify a change.