BOOTC(8)

πŸ‘‘ BOOTC β€” the bootc manual page, section 8 (System Manager's Manual) πŸ’…

okay bestie, sit down, we're learning bootc and honestly? it's giving main character energy for your whole OS. this is the page for the bootc command, from section 8 of the System Manager's Manual. let's GO πŸš€


✨ NAME ✨

bootc β€” deploy and transactionally in-place with bootable container images 🐳


πŸŽ€ SYNOPSIS πŸŽ€

bootc [OPTIONS...] <SUBCOMMAND>

πŸ¦‹ DESCRIPTION πŸ¦‹

Deploy and transactionally in-place with bootable container images. yes, that's the whole vibe β€” your OS is a container image and it updates like one. no cap. ✨

the bootc project currently uses ostree-containers as a backend to support the whole bootable-container-image model. once it's installed β€” whether that happened directly via bootc install (which, btw, gets executed as part of a container) or through some other mechanism like an OS installer tool β€” further updates can be pulled with bootc upgrade. like, that's it. that's the loop. πŸ”

for guides to building, installing, and managing bootable images, see bootc-docs(7). go read it, i'll wait. 🫢


πŸ’– SUBCOMMANDS πŸ’–

every single one of these is a full mood, and every single one is listed here, no skipping:

  • bootc upgrade β€” download an updated container image and queue it up to apply. future you is gonna be so happy πŸ™ˆ
  • bootc switch β€” target a new container image reference for the system to boot. changing your whole image? slay πŸ’…
  • bootc rollback β€” change the bootloader entry ordering; the deployment under rollback will be queued for the next boot, and the current one will become rollback. and if there's a staged entry (that's an unapplied, queued upgrade) then it will be discarded πŸ’€ so yeah, know what you're doing before you run this one.
  • bootc edit β€” apply full changes to the host specification. like, the whole thing. ✨
  • bootc status β€” display status. the "am i okay" check. run it. always run it. 🌸
  • bootc usr-overlay β€” add a transient overlayfs on /usr. temporary, bestie. transient. don't get attached πŸ¦‹
  • bootc install β€” install the running container to a target 🎯
  • bootc container β€” operations which can be executed as part of a container build πŸ”₯
  • bootc loader-entries β€” operations on Boot Loader Specification (BLS) entries πŸ‘‘

🌈 SEE ALSO 🌈


⭐ VERSION ⭐

  • v1.17.1 β€” that's the version, periodt πŸ’œ

okay that's the whole page, you ate it, i'm obsessed 🫢 this was BOOTC(8) from the System Manager's Manual, and this version is v1.17.1. go update something (safely). mwah πŸ’–βœ¨πŸŽ€

πŸ“¦ where this page comes from
  • fedora 43: bootc 1.17.1-1.fc43 Β· Apache-2.0 AND BSD-3-Clause AND MIT AND (Apache-2.0 OR BSL-1.0) AND (Apache-2.0 OR MIT) AND (Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT) AND (Unlicense OR MIT)
  • fedora 44: bootc 1.17.1-1.fc44 Β· Apache-2.0 AND BSD-3-Clause AND MIT AND (Apache-2.0 OR BSL-1.0) AND (Apache-2.0 OR MIT) AND (Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT) AND (Unlicense OR MIT)
  • πŸ’– girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms