OSTREE ADMIN UPGRADE(1)

    .SH "NAME" ostree-admin-upgrade - Construct new tree from current origin and deploy it, if it changed
    .SH "SYNOPSIS"
            .HP u
                ostree admin upgrade [OPTIONS...]

    .SH "DESCRIPTION"

        .PP Downloads the latest version of the current ref from the build server and deploys it, if it changed. Reboot the machine for the changes to take effect. These phases can be split via --pull-only and --deploy-only.

    .SH "OPTIONS"

            .PP --os="STATEROOT"

                    Use a different operating system root than the current one.
                .RE
                .PP --pull-only

                        Only perform a pull into the repository; do not create a deployment. This option can hence safely be used in a background scheduled job with the assurance of not changing system state.
                    .RE
                    .PP --deploy-only

                            Create a new deployment from the latest commit in the tracked origin refspec. This option is intended to be used by a scheduled system that detected changes via --pull-only, and is ready to deploy them.
                        .RE
                        .PP --stage

                                Perform deployment finalization at shutdown time. Recommended, and will likely become the default in the future.
                            .RE

                            .PP --reboot,-r

                                    Reboot after a successful upgrade.
                                .RE

                                .PP --allow-downgrade

                                        Permit deployment of chronologically older trees.
                                    .RE
                                    .PP --override-commit="CHECKSUM"

                                            Deploy CHECKSUM instead of the latest tree.
                                        .RE

                                .SH "EXAMPLE"

                                    .PP $ ostree admin upgrade

                                        No update available.