BOOTC-ROLLBACK(8)

💫 BOOTC-ROLLBACK — bestie edition (section 8, System Manager's Manual) 💫

okay so you found bootc-rollback, and honestly? she's a shapeshifter for your bootloader. let's get into it 🫶

---

✨ NAME ✨

bootc-rollback — change the bootloader entry ordering (yes, that's it, that's the whole personality, and she slays at it)

---

🌸 SYNOPSIS 🌸

bootc rollback [OPTIONS...]

---

💅 DESCRIPTION 💅

so what she does is: she changes the bootloader entry ordering. the deployment sitting under the rollback gets queued up for your next boot, and the one you're on right this second becomes the rollback. it's giving musical chairs but make it systemd 🔥

and listen — if there's a staged entry (that's an unapplied, queued upgrade, a lil upgrade ghost just vibing in the queue), she discards it. gone. bye. 💀

⚠️ big brain warning: with no extra control logic on top, if there's an active agent out here doing automated upgrades — think the default bootc-fetch-apply-updates.timer and its associated .service — the change you make here may be reverted. so basically it's recommended to only use this in concert with an agent that's in active control. don't fight the automation, coordinate with it, iykyk 😭

also she logs a systemd journal message with MESSAGE_ID=26f3b1eb24464d12aa5e7b544a6b5468 so that a rollback invocation can be detected. lowkey a little signature tag, iconic of her 💖

🎀 Note on Rollbacks and the /etc Directory 🎀

bestie this part matters, sit with me for a sec 🌸

when you do a rollback (like with bootc rollback), any changes you made to files in the /etc directory won't carry over to the rolled-back deployment. nope! those /etc files revert to their state from that previous deployment instead. ngl that surprises people every single time 🙈

and the why is actually really cute and simple: bootc rollback just reorders the existing deployments. she doesn't create new ones. periodt. the /etc merges happen when new deployments are created — different event, different queen 👑

---

⭐ OPTIONS ⭐

• --apply — restart or reboot into the rollback image. she doesn't just queue it, she goes 👑
• --soft-reboot=SOFT_REBOOT — configure soft reboot behavior. it's giving "how dramatic should this reboot be"

possible values:

• required
• auto

---

🦋 EXAMPLES 🦋

rollback to the previous deployment — the classic, the og:

bootc rollback

rollback and immediately apply the changes — no waiting, main character energy:

bootc rollback --apply

rollback with soft reboot if possible — polite and efficient, we stan:

bootc rollback --apply --soft-reboot=auto

---

🍓 SEE ALSO 🍓

bootc(8), bootc-upgrade(8), bootc-switch(8), bootc-status(8) — go read the whole friend group, they're all gorgeous ✨

---

💜 VERSION 💜

v1.17.1

---

and that's a wrap on bootc-rollback(8) from your System Manager's Manual, bestie 💖 go forth, roll back responsibly, and remember: reordering is a love language. no cap. ✨🎀🦋🌸

mwah 💅