---
name: "ostree-admin-switch"
section: "1"
platform: "linux"
package: "ostree"
version: "2026.4-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/ostree-admin-switch"
---

# ostree-admin-switch(1)

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

## NAME

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

## SYNOPSIS

**ostree admin switch** {REF}

## DESCRIPTION

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.

## EXAMPLE

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