Some checks are pending
ci / test (push) Waiting to run
Adds scripts/context.sh + 'make context' (one-screen session briefing), scripts/doctor.sh + 'make doctor' (host prerequisites), docs/HANDOFF.md (rolling cross-session note), docs/adr/ (BLS, desktop profile, keyring, Rust), .githooks/commit-msg (Conventional Commits), .gitattributes, scripts/backup-git.sh + 'make backup', and a Forgejo Actions CI workflow. Updates AGENTS.md reading order/work loop and DEVELOPMENT.md.
921 B
921 B
ADR 0002: BLS entries instead of UKI for the boot path
- Status: Accepted
- Date: 2026-09-20
Context
UKIs are desirable, but the available dracut UKI generator produced a UKI that
did not embed /etc/kernel/cmdline; the image booted with no root= and
fell into an initramfs emergency shell. Boot reliability is a defining value.
Decision
Use layout=bls: installkernel places the kernel and dracut initramfs on the
ESP and creates Boot Loader Specification entries whose options carry the
kernel command line. Defer UKI until a generator that embeds the command line
is proven in the VM.
Consequences
- The proven path boots reliably with systemd-boot and BLS.
- UKI/Secure Boot remain future work; do not switch the default to UKI without a VM boot test.
uki_generator=noneis required in/etc/kernel/install.confbecause installkernel always expects auki_generatorkey.