phoebus_os/docs/adr/0002-bls-over-uki.md
Phoebus 83368f774c
Some checks are pending
ci / test (push) Waiting to run
feat(git): add session context, host doctor, ADRs and git hygiene
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.
2026-09-20 02:36:32 -07:00

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=none is required in /etc/kernel/install.conf because installkernel always expects a uki_generator key.