OSTREE ADMIN SWITCH(1) ostree admin switch OSTREE ADMIN SWITCH(1)

.SH "NAME" ostree-admin-switch - Construct new tree from current origin and deploy it, if it changed

.SH "SYNOPSIS"

.HP 480u

**ostree admin switch** {REF}

.SH "DESCRIPTION"

.PP Choose a different REF from the current remote to track. This is the ref that will be "tracked" and upgraded with **ostree admin upgrade**. Like an upgrade, the operating system state will be preserved.

.SH "OPTIONS"

.PP **--reboot**,**-r**

Reboot after a successful switch.

.RE

.PP **--kexec**,**-k**

Load new deployment into kexec after a successful switch.

.RE

.PP **--os**="STATEROOT"

Use a different operating system root than the current one.

.RE

.SH "EXAMPLE"

.PP **$ ostree admin switch fedostree/20/workstation/gnome/core**

OSTree

---

Document: ostree-admin-switch(1) from ostree 2026.4-r4 (Chainguard OS)
Source: https://github.com/ostreedev/ostree