OSTREE-ADMIN-DEPLOY(1)

🌸 NAME 🌸

okay so this is the OSTREE ADMIN DEPLOY(1) manual, bestie, and the star of the show is ostree-admin-deploy — checkout a revision as the new default deployment. 💅

🎀 SYNOPSIS 🎀

ostree admin deploy [OPTIONS...] {REFSPEC}

💖 DESCRIPTION 💖

So ostree admin deploy takes a commit or revision REFSPEC, and queues the new deployment as default upon reboot. That’s the whole vibe. ✨

🌸 OPTIONS 🌸

• --stateroot="STATEROOT" — use a different operating system stateroot than the current one.
• --os="STATEROOT" — alias for --stateroot. same energy, different flag name. 🫶
• --origin-file="FILENAME" — use FILENAME as the origin, which is where OSTree will look for updated versions of the tree.
• --retain — do not delete previous deployment.
• --retain-pending — do not delete pending deployments.
• --retain-rollback — do not delete rollback deployments.
• --not-as-default — append rather than prepend new deployment.
• --lock-finalization — the deployment will not be "finalized" by default on shutdown; to later queue it, use ostree admin lock-finalization --unlock.
• --karg-proc-cmdline — import current /proc/cmdline.
• --karg="NAME=VALUE" — set kernel argument, like root=/dev/sda1; this overrides any earlier argument with the same name.
• --karg-append="NAME=VALUE" — append kernel argument; useful with e.g. console= that can be used multiple times.
• --karg-delete="NAME=VALUE" — delete kernel argument if exists, can be used multiple times.

🦋 EXAMPLE 🦋

$ ostree admin status

            * gnome-ostree 67e382b11d213a402a5313e61cbc69dfd5ab93cb07.0
                origin refspec: gnome-ostree/buildmain/x86_64-runtime
              gnome-ostree ce19c41036cc45e49b0cecf6b157523c2105c4de1ce3.0
                origin refspec: gnome-ostree/buildmain/x86_64-runtime

$ ostree admin deploy gnome-ostree/buildmain/x86_64-runtime

            ostadmin: Creating deployment /ostree/deploy/gnome-ostree/deploy/7e382b11d213a402a5313e61cbc69dfd5ab93cb07.1
            ostadmin: Processing /etc: 3 modified, 0 removed, 29 added
            Transaction complete: bootconfig swap: no deployment count change: 0)

$ ostree admin status

              gnome-ostree 67e382b11d213a402a5313e61cbc69dfd5ab93cb07.1
                origin refspec: gnome-ostree/buildmain/x86_64-runtime
            * gnome-ostree 67e382b11d213a402a5313e61cbc69dfd5ab93cb07.0
                origin refspec: gnome-ostree/buildmain/x86_64-runtime

---

Signed off with 💜 from the OSTree manual, page OSTREE ADMIN DEPLOY(1) — source: OSTree; version/date: not printed in this footer, so I’m not making one up, bestie. 🫶