Quickstart

Use the repository Makefile for normal work.

make doctor      # common health check
make phases      # print the numbered learning flow
make phase 0     # run all Phase 0 steps
make phase 1     # run all Phase 1 steps
make phase 2     # run the canonical Phase 2 path
make phase 3     # explain deferred ONIX-owned kernel work
make phase 4     # run every Phase 4 booted-base step

Individual steps use three digits:

002 = Phase 0, step 02
102 = Phase 1, step 02
212 = Phase 2, step 12
213 = Phase 2, step 13
214 = Phase 2, step 14
300 = Phase 3, step 00
400 = Phase 4, step 00
401 = Phase 4, step 01
402 = Phase 4, step 02
403 = Phase 4, step 03
404 = Phase 4, step 04
405 = Phase 4, step 05
406 = Phase 4, step 06
407 = Phase 4, step 07
408 = Phase 4, step 08
409 = Phase 4, step 09
410 = Phase 4, step 10

Examples:

make phase 002   # build the forge disk
make phase 003   # boot the forge VM
make phase 101   # build onix-branding
make phase 213   # stage the first musl systemd userspace payload
make phase 214   # stage the first kernel module/kmod payload
make phase 212   # run the ONIX boot probe
make phase 300   # document deferred kernel ownership
make phase 400   # start booted-base userspace planning
make phase 401   # materialize live /etc from packaged defaults
make phase 402   # materialize base users/groups/shell policy
make phase 403   # prove bootstrap serial root console
make phase 404   # prove minimal QEMU user networking
make phase 405   # prove host-to-guest TCP inspection
make phase 406   # prove authenticated SSH access
make phase 407   # audit temporary Nix-sourced system payloads
make phase 408   # define local stone/repo contract
make phase 409   # build source-based onix-busybox stone
make phase 410   # install/use onix-busybox in the image

Phase 3 is intentionally reserved for ONIX-owned kernel/initramfs/modules work. For now ONIX keeps using the borrowed Alpine virt kernel payload proved in Phase 2, and Phase 4 continues with booted userspace work.

Some phases can be watched interactively:

ATTACHED=1 make phase 212
make phase 212 ATTACHED=1

For Phase 212, attached mode uses the serial console in the current terminal by default. GUI/VNC only starts when explicitly requested:

ONIX_BOOT_PROBE_DISPLAY=gtk ATTACHED=1 make phase 212
ONIX_BOOT_PROBE_DISPLAY=vnc ATTACHED=1 make phase 212

Book commands

Build the book:

make book

Serve the book locally:

make book-serve

The generated HTML goes under:

book/html/

That directory is generated output and is not committed.