BOOTC-UPGRADE(8)

💅 BOOTC-UPGRADE(8) — the bootc-upgrade page, but make it make sense

okay so bestie, this one lives in the System Manager's Manual section 8, and it's literally the glow-up button for your system. buckle up 🎀

---

✨ NAME ✨

bootc-upgrade — download and queue an updated container image to apply 🦋

---

🌸 SYNOPSIS 🌸

bootc upgrade [OPTIONS...]

---

💖 DESCRIPTION 💖

Download and queue an updated container image to apply. that's the whole vibe, no cap.

here's the important part though: this does not affect the running system. nope. updates operate in an "A/B" style by default, so your currently-running self is safe and sound while the new one waits in the wings 💅

a queued update shows up as staged in bootc status. so if you're wondering "did it work??" — go check status, bestie.

---

🔍 Checking for Updates 🔍

the --check option lets you verify if updates are available without downloading the full image layers. it only grabs the updated manifest and image configuration (typically kilobyte-sized metadata, tiny little snack 🍓), which makes it much faster than a full upgrade. it's giving "peek at the menu before you order" energy.

---

🚀 Applying Updates 🚀

currently, by default, the update gets applied at shutdown time via ostree-finalize-staged.service. so it kinda just... happens when you leave. iconic behavior honestly.

there's also an explicit bootc upgrade --apply verb which will automatically take action (rebooting, bestie, a whole reboot) if the system has changed.

⚠️ however — in the future this is likely to change, such that reboots outside of a bootc upgrade --apply do not automatically apply the update in addition. so don't build your whole personality around the current default, k? 😭

---

🧚 Soft Reboot 🧚

for shared --apply and --soft-reboot behavior, see Soft reboots (check out bootc-upgrades(7)). go read it, it's right there 🫶

---

👑 OPTIONS 👑

• --quiet — don't display progress. silence, but make it ✨intentional✨
• --check — check if an update is available without applying it
• --apply — restart or reboot into the new target image 🔥
• --soft-reboot=SOFT_REBOOT — configure soft reboot behavior
  • possible values:
    • required
    • auto
• --download-only — download and stage the update without applying it
• --from-downloaded — apply a staged deployment that was previously downloaded with --download-only
• --tag=TAG — upgrade to a different tag of the currently booted image 🌈

---

🌟 EXAMPLES 🌟

check for available updates:

bootc upgrade --check

upgrade and immediately apply the changes:

bootc upgrade --apply

upgrade with soft reboot if possible:

bootc upgrade --apply --soft-reboot=auto

upgrade to a different tag:

bootc upgrade --tag v1.2

check if a specific tag has updates before applying:

bootc upgrade --tag prod --check

upgrade to a tag and immediately apply:

bootc upgrade --tag v2.0 --apply

---

🦋 SEE ALSO 🦋

bootc(8), bootc-switch(8), bootc-status(8), bootc-rollback(8) — the whole friend group, go say hi 💜

---

⭐ VERSION ⭐

v1.17.1 — yeah that's the version, and that's the tea ☕

---

and that's the whole page, bestie!! you ate this. go forth and bootc upgrade responsibly. mwah 💖🎀✨ periodt.

BOOTC-UPGRADE(8) — part of the System Manager's Manual, version v1.17.1. bye babes!! 🫶