OSTREE-ADMIN-UPGRADE(1)

📦
version 2026.6 · 16 versions
, in arch rolling

✨ ostree-admin-upgrade ✨

okay bestie, welcome to the glow-up page for ostree admin upgrade — the part of the ostree admin fam that pulls down a fresh tree and actually deploys it 💅

🌸 NAME 🌸

ostree-admin-upgrade — builds a whole new tree out of your current origin and deploys it, but only if it actually changed. no change, no chaos 💖

🦋 SYNOPSIS 🦋

ostree admin upgrade [OPTIONS...]

🎀 DESCRIPTION 🎀

so here's the vibe: it downloads the latest version of the current ref from the build server and deploys it — if it changed. if nothing changed, it's giving "nothing to see here" energy and you just move on 🫶

then you reboot the machine for the changes to actually take effect, because that's the whole final step, no cap.

and the best part? these phases can be split using --pull-only and --deploy-only — so you can pull in one moment and deploy in another, iykyk ✨

💅 OPTIONS 💅

  • --os="STATEROOT" — use a different operating system root than the current one. like, "not this os, the other one" 🦋
  • --pull-only — only does a pull into the repository, and does not create a deployment. so this one's super safe to drop in a background scheduled job, with the assurance that it won't change system state at all. literally the chillest option here 😌
  • --deploy-only — creates a new deployment from the latest commit in the tracked origin refspec. this is meant for a scheduled system that spotted changes via --pull-only and is now ready to deploy them. teamwork, fr fr 🤝
  • --stage — performs deployment finalization at shutdown time. recommended, and it'll likely become the default in the future. so like, get on board now, bestie 👑
  • --reboot, -r — reboot after a successful upgrade. simple, iconic, does exactly what it says 🔥
  • --kexec, -k — load the new deployment into kexec after a successful upgrade. fancy 😭
  • --allow-downgrade — permits deployment of chronologically older trees. going backwards on purpose, bold move 🫣
  • --override-commit="CHECKSUM" — deploy CHECKSUM instead of the latest tree. you pick the commit, you're the main character now 💜

⭐ EXAMPLE ⭐

$ ostree admin upgrade

            No update available.
also there's literally nothing to do in that example and it says so. slay.

and that's the whole page, bestie 🎀 this was ostree admin upgrade, from the ostree manual (that's the source + version bit), dated the same as the original page — mwah, catch you in the next manpage 💖✨🦋

📦 where this page comes from