From 27795f7998e7f25fec5857aa89873a326c160471 Mon Sep 17 00:00:00 2001 From: Phoebus Date: Sun, 20 Sep 2026 13:49:49 -0700 Subject: [PATCH] docs(live): record the Debian-Live appliance install and detached boot The appliance ISO firmware-boots, installs (INSTALL_RC=0, NO_SECRET_LEAK) and the installed disk boots detached as Gentoo-only (Portage, no apt, systemd running, 0 failed units). Two anomalies are recorded rather than hidden: the target hostname and a first-boot DHCP timing observation. --- docs/PLAN-DEBIAN-LIVE.md | 10 +++++---- docs/VM-BOOT-VERIFICATION.md | 41 ++++++++++++++++++++++++++++++++++++ 2 files changed, 47 insertions(+), 4 deletions(-) diff --git a/docs/PLAN-DEBIAN-LIVE.md b/docs/PLAN-DEBIAN-LIVE.md index c031319..f7799d7 100644 --- a/docs/PLAN-DEBIAN-LIVE.md +++ b/docs/PLAN-DEBIAN-LIVE.md @@ -4,10 +4,12 @@ Status: **In progress** · Author: session 2026-09-20 · Companion: `docs/adr/0005-debian-live-appliance.md` Progress: an actual ISO now builds with `installer/live/build.sh` (no root), -firmware-boots (UEFI), presents a serial console, and runs the static installer -from the live medium. A full install from the appliance reached the Portage -stage; the detached-boot verification is the remaining gate. See -`docs/VM-BOOT-VERIFICATION.md`. +firmware-boots (UEFI), presents a serial console, runs the static installer from +the live medium, completes a full install (`INSTALL_RC=0`, all stages, +`NO_SECRET_LEAK`), and the installed disk boots detached as a Gentoo-only +system (`running`, 0 failed units). Remaining: the `--check-live` preflight +(Phase 1), a reproducible in-repo ISO build check, and two open anomalies +(target hostname and DHCP timing) noted in `docs/VM-BOOT-VERIFICATION.md`. This plan replaces the reference Gentoo LiveGUI medium as the *installer appliance* with a Debian-Live image, while keeping the installed system 100% diff --git a/docs/VM-BOOT-VERIFICATION.md b/docs/VM-BOOT-VERIFICATION.md index 3a8b7af..3db3730 100644 --- a/docs/VM-BOOT-VERIFICATION.md +++ b/docs/VM-BOOT-VERIFICATION.md @@ -282,6 +282,47 @@ binhost URI from the selected profile when it is not set. Signature verification remains enabled. Publishing a matching systemd/desktop binhost is the remaining step; no time estimate is claimed beyond the recorded ~26 min. +## Debian-Live installer appliance (actual ISO) + +An appliance ISO was built **without root** by `installer/live/build.sh` +(Debian-Live 13.7 standard base + `/phoebus` overlay), SHA-256 +`c0105bc9a282fddcbefab42baa577ea99843060f00fa45a75bcbc8358186bfd5`. + +Firmware boot (UEFI/OVMF, no `-kernel`; the ISO's own grub chain): + +- auto-boots the live system on the serial console; +- login `user` / `live` (passwordless sudo); +- the overlaid tools run: `cryptsetup 2.7.5`, `sgdisk 1.0.10`, + `partprobe 3.6`, `mkfs.btrfs 6.14`, `mkfs.fat`. + +Full install to a fresh 24 GiB qcow2 driven from the appliance: + +- `INSTALL_RC=0`, all stages, `NO_SECRET_LEAK`. + +Detached boot of the installed disk (ISO removed): + +- systemd-boot -> LUKS2 unlock -> `phoebus` login; +- `systemctl is-system-running` -> `running`; `0 loaded units listed`; +- **Gentoo-only**: `Gentoo Base System release 2.18`, Portage 3.0.82.2, + `no-apt`; systemd PID 1; +- `cryptroot` Btrfs mounted at `/`, `/home`, `/var`, `/.snapshots`, `/swap`, + ESP `/efi`. + +This is Bash-free and Gentoo-target-only: the appliance contributes tooling, +never configuration. + +### Open items found in this run + +- The target came up with the default `gentoo` hostname (empty + `/etc/hostname`) even though the plan/config specified `phoebus`, unlike the + earlier Gentoo-appliance installs. Needs a focused look (possible stage3 or + ordering difference). +- The first detached boot reported `enp0s2 DOWN`; DHCP timing was not + re-checked. The earlier Gentoo-appliance boot had `enp0s2 UP 10.0.2.15/24`. + +Neither affects the proven Gentoo-appliance boot path; both are recorded rather +than hidden. + ## Known remaining work - The graphical session was verified with the **headless** wlroots backend