BOOTC-CONTAINER-UKIFY(8)

💖 BOOTC-CONTAINER-UKIFY — the bootc-container-ukify(8) page, but make it cute ✨

okay bestie, welcome to bootc-container-ukify(8) from the System Manager's Manual 🫶 this is the one that builds you a Unified Kernel Image and honestly it's giving main character energy.

---

🌸 NAME

bootc-container-ukify — Build a Unified Kernel Image (UKI) using ukify 💅

---

✨ SYNOPSIS

bootc container ukify [OPTIONS] [-- UKIFY_ARGS...]

---

🦋 DESCRIPTION

Build a Unified Kernel Image (UKI) using ukify. no cap, that's the whole vibe.

This command computes the necessary arguments from the container image (kernel, initrd, cmdline, os-release) and then invokes ukify with them. literally it does the homework for you 📚 and any additional arguments you drop after -- are passed through to ukify unchanged — untouched, unbothered, iconic.

Unless --erofs-version=v2 is specified, the generated UKI contains the V1 composefs argument followed by a V2 fallback. and bestie, hear me: the command does not inspect the initramfs to choose a format. Explicit V2 emits only the legacy V2 argument. When using the default output, the initramfs in the image must be regenerated with a bootc version that supports V1 before the UKI is built. yes that's a whole prerequisite, we don't make the rules 😭

---

👑 OPTIONS

• ARGS — Additional arguments to pass to ukify (after --)
• --rootfs=ROOTFS — Operate on the provided rootfs. Default: /
• --allow-missing-verity — Make fs-verity validation optional in case the filesystem doesn't support it. (the "no fs-verity? that's fine, we move" flag 🫶)
• --erofs-version=EROFS_VERSION — EROFS format version to use when computing the composefs digest
  • Possible values:
    • v1
    • v2
• --write-dumpfile-to=WRITE_DUMPFILE_TO — Write a dumpfile to this path 📝
• --kernel-dir=KERNEL_DIR — The directory containing the kernel and initramfs.img. Must be of the format /parent/$kernel_version ⭐

---

🌈 EXAMPLES

okay so here's the moment you've been waiting for, the actual demo:

bootc container ukify --rootfs /target -- --output /output/uki.efi

slay. that's it. that's the whole thing 💖

---

🎀 SEE ALSO

bootc(8), ukify(1) — go read those too, they're literally the besties of this page 🧚

---

🍓 VERSION

v1.17.1

---

and that's a wrap on bootc-container-ukify(8) from the System Manager's Manual, version v1.17.1 💜 you ate this page up fr fr, now go build that UKI bestie 🫶✨