| OSTREE ADMIN DEPLOY(1) | ostree admin deploy | OSTREE ADMIN DEPLOY(1) |
.SH "NAME" ostree-admin-deploy - Checkout a revision as the new
default deployment
.SH "SYNOPSIS"
.HP 480u
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 --stateroot="STATEROOT"
Use a different operating system stateroot than the current one.
.RE
.PP --os="STATEROOT"
Alias for --stateroot.
.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 --lock-finalization
The deployment will not be "finalized" by default on shutdown; to
later queue it, use ostree admin lock-finalization --unlock.
.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
.PP --karg-delete="NAME=VALUE"
Delete kernel argument if exists, 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
| OSTree |