OSTREE ADMIN DEPLOY(1)

    .SH "NAME" ostree-admin-deploy - Checkout a revision as the new default deployment
    .SH "SYNOPSIS"
            .HP u
                ostree admin deploy [OPTIONS...] {REFSPEC}

    .SH "DESCRIPTION"

        .PP Takes a commit or revision REFSPEC, and queues the new deployment as default upon reboot.

    .SH "OPTIONS"

            .PP --os="STATEROOT"

                    Use a different operating system root than the current one.
                .RE
                .PP --origin-file="FILENAME"

                        Use FILENAME as the origin, which is where OSTree will look for updated versions of the tree.
                    .RE
                    .PP --retain

                            Do not delete previous deployment.
                        .RE
                        .PP --retain-pending

                                Do not delete pending deployments.
                            .RE
                            .PP --retain-rollback

                                    Do not delete rollback deployments.
                                .RE
                                .PP --not-as-default

                                        Append rather than prepend new deployment.
                                    .RE
                                    .PP --karg-proc-cmdline

                                            Import current /proc/cmdline.
                                        .RE
                                        .PP --karg="NAME=VALUE"

                                                Set kernel argument, like root=/dev/sda1; this overrides any earlier argument with the same name.
                                            .RE
                                            .PP --karg-append="NAME=VALUE"

                                                    Append kernel argument; useful with e.g. console= that can be used multiple times.
                                                .RE

                                        .SH "EXAMPLE"

                                            .PP $ 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