ostree-admin-switch(1)

ostree-admin-switch1

Construct new tree from current origin and deploy it, if it changed

Usage

ostree admin switch REF

Overview

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.

Options

--reboot,-r

Reboot after a successful switch.

--kexec,-k

Load new deployment into kexec after a successful switch.

--os="STATEROOT"

Use a different operating system root than the current one.

Examples

$ ostree admin switch fedostree/20/workstation/gnome/core

Releases

6 releases since Debian 9 (Stretch); the text changed 5 times.

  1. 9
  2. 10
  3. 11
  4. 12
  5. 13
  6. Arch

--kexec since Debian 13 (Trixie); --reboot since Debian 13 (Trixie); -k since Debian 13 (Trixie); -r since Debian 13 (Trixie).

From ostree 2026.4-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.