OSTREE-ADMIN-LOCK-FINALIZATION(1)

💅 ostree-admin-lock-finalization(1) — the lock-finalization glow-up

okay bestie, so this is a page from the ostree admin lock-finalization part of the manual, and it's genuinely a little baddie. let's get into it 🎀

---

✨ NAME ✨

ostree-admin-lock-finalization — literally just changing whether a staged deployment gets queued for the next boot. that's the whole vibe check. 👑

🌸 SYNOPSIS 🌸

ostree admin lock-finalization [OPTIONS...]

🦋 DESCRIPTION 🦋

okay so first thing's first: this command requires a staged deployment. no staged deployment, no service 💅 like it's not gonna work without one, periodt.

by default — and this is the main character behaviour of the whole thing — this command makes sure the deployment gets set into a "finalization locked" state. and what does that mean? it means it will not be queued for the next boot by default. it's giving "we're staying right here, thanks." 🙈

highkey important: this is the same thing as the --lock-finalization argument for ostree admin deploy. and ngl, that ostree admin deploy route is the recommended way to use this feature, because it's the race-free way to do it. 🏁 (race conditions are NOT the vibe.)

but — and this is the more common scenario, fr fr — usually you're gonna use the --unlock argument on this command to later unlock a deployment that was finalization locked. so like: locked earlier, unlocked now. character development. 🌈

💀 quick note so you don't clown yourself: this needs a staged deployment. it says so right at the top. don't come for me.

💖 OPTIONS 💖

• --sysroot="PATH" — points at the path to the system you wanna use instead of the current one. like, "not this system, that system." 🫶
• --unlock, -u — unlocks the deployment finalization state. the un-locking. the freedom era. 🕊️

---

🌟 the cute sign-off 🌟

and that's the page, bestie — this one's brought to you by OSTree (that's the source/version energy at the bottom of the original, and the OSTREE ADMIN LOCK-F(1) header up top that we folded in here instead of copy-pasting it like a boring person). go forth, lock and unlock responsibly, and remember: race-free or it didn't happen ✨💜