Skip to main content

references

Curated 2026-07-19. Each entry explains the lesson it provides. Organized by the milestone it feeds (see ROADMAP.md).

M0 — MVP hardening (rollback, health)​

M2 — Bootloader migration (#65)​

  • bootupd — https://github.com/coreos/bootupd. bootc's bootloader manager. bootc install runs it. It updates GRUB and shim. For systemd-boot, it defers to bootctl. For #65, a migrated system must use a state that bootupd recognizes or does not manage. Important interaction: bootc auto-detection for sealed composefs needs an image without bootupd (see M4).
  • Fedora bootloader phases — https://fedoraproject.org/wiki/Changes/BootLoaderUpdatesPhase1. Phase 1 uses static GRUB with BLS. Phase 2 builds a new boot chain with bootupd. It keeps the previous chain as a fallback. This pattern validates our one-boot trial design.
  • openSUSE sdbootutil — https://en.opensuse.org/Systemd-boot, https://microos.opensuse.org/blog/2023-12-20-sdboot-fde/. The sdbootutil project provides a mature production migration from GRUB to systemd-boot. Its bootctl wrapper tracks kernel, command line, and initrd data for each snapshot. It supports FDE through TPM2 policy prediction with systemd-pcrlock or pcr-oracle. It also documents an in-place migration: zypper rm grub2-common; zypper in sdbootutil systemd-boot. openSUSE changed the Tumbleweed default to GRUB2-BLS in 2025 (https://news.opensuse.org/2025/11/13/tw-grub2-bls/). BLS-native GRUB2 can avoid the ESP resync problem. For #65: consider grub2-bls as a cheaper interim target on systems that cannot use sd-boot. Causes include read-only NVRAM and unusual ESPs.
  • kernel-install / BLS spec — sdbootutil and Fedora use entries of type 1 from the Boot Loader Specification. The standalone path installs /etc/kernel/install.d/95-bootc-migrate-esp-sync.install as the resync drop-in. The hook receives the kernel and initramfs paths directly from kernel-install, so this path does not need a fallback unit.

M4 — Native store & generation matrix (#13, #72)​

M1/M3 — Re-base engine & cross-base (comparative architectures)​

M5 — Desktop & UX (#68, #15, #31)​

Upstream watch list (subscribe, don't poll)​

WhatWhereWhy
bootc releaseshttps://github.com/bootc-dev/bootc/releases/cfs CLI drift arrives here first
composefs-native trackinghttps://github.com/bootc-dev/bootc/issues/1190format/CLI direction
composefs-rs releasescrates.io composefs/composefs-ociNativeStore dependency floor
ostree composefs trackinghttps://github.com/ostreedev/ostree/issues/2867legacy-side integration
greenboot-rshttps://github.com/fedora-iot/greenboot-rshealth-check contract for #22/#26
sdbootutil newshttps://news.opensuse.org/tag/sdbootutil/sd-boot/FDE migration practice