Dosu LogoDosu Logo
Ask
Join our Discord
Organization avatar
bluefinPublic
Bluefin
Documentsbluefin
2026-03-30-boot-verification-design
2026-03-30-boot-verification-design
Type
External
Status
Published
Created
Jun 13, 2026
Updated
Jun 13, 2026
Source
docs/superpowers/specs/2026-03-30-boot-verification-design.md

Boot Verification for Bootcrew Nightly CI#

Date: 2026-03-30
Status: Approved


Context#

The bootcrew-nightly.yml workflow installs each matrix image onto a loop device and verifies the resulting partition structure and file layout. It does not verify that the installed system actually boots. A broken GRUB config, corrupt initrd, or bad EFI entry would pass the current checks.

This spec adds a QEMU+OVMF boot step after the existing install verification. It boots the loop device as a full VM and waits for a login prompt on the serial console. Failure to reach a login prompt within the timeout fails the matrix job.


Scope#

One deliverable: modify .github/workflows/bootcrew-nightly.yml to add boot verification after the existing install verification step.

No new files. No changes to fisherman Go code. No changes to bootcrew-fast.yml (that workflow uses fake podman and produces no bootable system).


Design#

Tools#

Add qemu-system-x86 ovmf to the existing sudo apt-get install -y line in the "Install tools" step:

sudo apt-get install -y podman xfsprogs btrfs-progs cryptsetup-bin ostree qemu-system-x86 ovmf

qemu-system-x86 provides qemu-system-x86_64. ovmf provides /usr/share/OVMF/OVMF_CODE.fd.

Boot command#

timeout 180 qemu-system-x86_64 \
  -enable-kvm \
  -m 2G \
  -drive file=$LOOPDEV,format=raw,if=virtio \
  -drive if=pflash,format=raw,readonly=on,file=/usr/share/OVMF/OVMF_CODE.fd \
  -serial stdio \
  -nographic \
  -no-reboot 2>&1 | tee /tmp/boot-$IMAGE_NAME.log
  • -enable-kvm: uses hardware virtualisation available on ubuntu-latest runners (/dev/kvm). Without this, boot would be prohibitively slow.
  • -m 2G: sufficient RAM for all matrix images to reach login.
  • -drive file=$LOOPDEV,format=raw,if=virtio: attaches the installed loop device as a virtio block device. virtio is faster than IDE and is supported by all matrix images.
  • -drive if=pflash,...,file=OVMF_CODE.fd: UEFI firmware. Required because the installed system's bootloader is an EFI application.
  • -serial stdio -nographic: all serial output goes to stdout, captured by tee.
  • -no-reboot: VM halts instead of rebooting on shutdown (prevents infinite boot loops on panic).
  • timeout 180: kills QEMU after 3 minutes if login prompt has not appeared.

Success detection#

grep -q "login:" /tmp/boot-$IMAGE_NAME.log

login: appears in the getty prompt on all major Linux distributions (ubuntu-bootc, gnomeos-bootc, opensuse-bootc, yellowfin). If the grep succeeds, the step passes. If timeout fires or the grep finds no match, the step exits non-zero and fails the matrix job.

SELinux#

The boot test boots whatever was installed. No kernel command-line overrides are applied. The existing matrix entry selinux_disabled: true for yellowfin-gnome50 only affects the bootc install flags; it does not affect how the installed system boots.

Timeout#

180 seconds. Expected boot times with KVM:

  • yellowfin-gnome50 (ostree/XFS): ~60s
  • ubuntu-bootc (composefs-native): ~90s
  • gnomeos-bootc (composefs-native): ~90s
  • opensuse-bootc (composefs-native): ~90s

180s gives ~2× headroom for runner variance.

Failure behaviour#

Boot failure fails the matrix job. fail-fast: false is already set on the matrix, so other images continue running. The job summary step (already present) reports per-image pass/fail.


Files modified#

FileChange
.github/workflows/bootcrew-nightly.ymlAdd qemu-system-x86 ovmf to apt install; add "Boot verification" step after "Verify installation"

Verification#

After implementation, trigger the workflow manually:

gh workflow run bootcrew-nightly.yml

Check that each matrix job shows a "Boot verification" step and that the log contains login:.

Documents
Changelogs
Bluefin LTS Errata
Pin Log
2024-12-30-ublue-2024-wrapup
2025-01-01-announcements-archive
2025-02-23-february-update
2025-05-14-bluefin-f42
2025-06-23-bazaar-default
2025-07-06-fresh-bluefin-isos-and-bazaar
2025-07-11-four-years-of-ublue
2025-07-15-bold-brew
2025-07-17-ask-projectbluefin
2025-08-01-august-wallpapers
2025-08-08-bluefin-on-lfx
2025-08-29-github-oss-fund
2025-09-17-color-with-bluefin
2025-09-18-bluefin-lts-and-gdx
2025-09-23-LTS-at-indiafoss
2025-10-28-bluefin-autumn
2025-10-31-fastfetch-metrics
2025-11-15-cloud-native-milestone-15-million
2025-11-16-coreos-desktop
2025-11-24-new-just-and-bbrew
2025-11-27-bluefin-and-paleoartists
2025-12-04-flatpak-support-in-brewfiles
2025-12-06-interview-with-michael-tunnell
2025-12-07-documentation-updates
2025-12-14-huntress-holiday-wallpapers
2025-12-15-easier-homebrew-installation-for-custom-images
2025-12-27-upcoming-homebrew-cli-changes
2025-12-30-bluefin-2025-wrapup
2026-01-03-modernizing-custom-images
2026-02-01-automated-reports-changelogs
2026-03-13-bluefin-cli-mac-wsl
2026-03-27-bluefin-lts-gnome-49-50
2026-03-29-composefs-fisherman
2026-03-29-composefs-fisherman-design
2026-03-30-boot-verification
2026-03-30-boot-verification-design
2026-03-30-proportional-progress-tracking
2026-03-30-proportional-progress-tracking-design
2026-04-02-state-of-ecosystem
2026-04-19-dakota-alpha-1
2026-05-12-bluefin-spring-2026
2026-05-13-bluefin-spring-2026-2
2026-05-14-making-our-own-fate
2026-05-15-hummingbird
2026-05-23-gradia-capture-bluefin
2026-05-28-knuckle
2026-06-11-promotion-pr-body
AGENTS
AGENTS
AGENTS
AGENTS
AGENTS
Building a Custom Bluefin Image
CI_CD_GUIDE
CLAUDE
CLAUDE
CONTRIBUTING
CONTRIBUTING
CONTRIBUTING
CONTRIBUTING
How can I install Double Commander on Bluefin (an immutable Linux OS), coming from Arch Linux?
How can you fix random GPU artifacts and hard freezes on an AMD Framework 16 laptop running Linux (Bluefin/Fedora)?
How do I install the Cloudflare WARP (One) client on Bluefin?
How to Reset a User's Home Directory to Defaults on Bluefin
INDEX
MAINTAINERS
MULTI_VARIANT_BUILD
PITFALLS
PULL_REQUEST_TEMPLATE
Plex Media Server
README
README
README
README
README
README
README
README
SECURITY
SECURITY
SKILL
SKILL
SKILL
SKILL
TRANSLATING
Update Process
Which Bluefin ISO is recommended for a Lenovo Yoga Pro 9i with an NVIDIA RTX 4050 for Python data science and Machine Learning with CUDA?
action-reference
actionadon
add-package
administration
agentic-contributing
ai
analytics
architect
architecture
artwork
blog-poster.agent
bluefin-dx
bonedigger-overview
bonedigger-templates
bonedigger-ujust
bst-overrides
build
build
buildstream
ci
ci
ci
code-of-conduct
command-line
composite-actions
consumer-guide
consumer-validation
contributing
conventional-commit.prompt
copilot-instructions
copilot-instructions
copilot-instructions
copilot-instructions
dakota-tpm2-validation
debugging
demo-mode-e2e
determinism
dinosaurs
downloads
downloads-testing
driver-versions
e2e-ci
e2e-feature-verification
encryption-matrix
factory-operations
failure-paths
feedback-loop
gstreamer-codec-validation
human-gates
images
index
index
installation
installer
label-workflow
libpastry-integration
live-iso
local-ota
luks-testing
merge-queue
mission
multi-arch
music
not-bluefin
oci-assembly
oci-layers
onboarding
overview
packaging-binaries
packaging-gnome-extensions
packaging-go
packaging-rust
packaging-zig
patch-junctions
patches
pr-checklist
pr-review
press-kit
projects
pull_request_template
pull_request_template
pull_request_template
qr-phone-companion
quickstart
r2-promotion
release-qualification
remove-package
reports
reusable-workflow
skill-improvement
supply-chain
t2-mac
testing
troubleshooting
ujust-recipes
update-refs
upgrade-and-migration
ux-ubuntu-provision
values
variants
vm-stack
workflow