docs(live): document the PHOEBUS_REUSE_ROOTFS build cache
Some checks are pending
ci / test (push) Waiting to run

This commit is contained in:
Phoebus 2026-09-21 06:47:53 -07:00
parent bbd3d89d6a
commit 0f6d503c2e

View file

@ -51,6 +51,9 @@ The default work directory is `/var/tmp/phoebus-live/build` (world-traversable,
because the rootless user namespace cannot enter a `0750` home directory); because the rootless user namespace cannot enter a `0750` home directory);
override with `WORKDIR=`. Output defaults to override with `WORKDIR=`. Output defaults to
`installer/live/phoebus-installer-amd64.iso` (+ `.sha256`); override with `OUT=`. `installer/live/phoebus-installer-amd64.iso` (+ `.sha256`); override with `OUT=`.
For fast iteration, `PHOEBUS_REUSE_ROOTFS=1` reuses an already-built
`$WORKDIR/livefs.tar` instead of re-running mmdebstrap; the assemble and pack
steps still run, so a normal build never needs it.
A normal build **produces the Mango desktop image**. The build fails clearly if A normal build **produces the Mango desktop image**. The build fails clearly if
`mango`, `dms`, quickshell, the live autologin config or the "Install Phoebus" `mango`, `dms`, quickshell, the live autologin config or the "Install Phoebus"