---
name: "ostree-admin-deploy"
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-deploy"
---

# ostree-admin-deploy(1)

Checkout a revision as the new default deployment

## NAME

ostree-admin-deploy - Checkout a revision as the new default deployment

## SYNOPSIS

**ostree admin deploy** \[OPTIONS...\] {REFSPEC}

## DESCRIPTION

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

## OPTIONS

- **--stateroot**="STATEROOT"

  Use a different operating system stateroot than the current one.

- **--os**="STATEROOT"

  Alias for --stateroot.

- **--origin-file**="FILENAME"

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

- **--retain**

  Do not delete previous deployment.

- **--retain-pending**

  Do not delete pending deployments.

- **--retain-rollback**

  Do not delete rollback deployments.

- **--not-as-default**

  Append rather than prepend new deployment.

- **--lock-finalization**

  The deployment will not be "finalized" by default on shutdown; to later queue it, use ostree admin lock-finalization --unlock.

- **--karg-proc-cmdline**

  Import current /proc/cmdline.

- **--karg**="NAME=VALUE"

  Set kernel argument, like root=/dev/sda1; this overrides any earlier argument with the same name.

- **--karg-append**="NAME=VALUE"

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

- **--karg-delete**="NAME=VALUE"

  Delete kernel argument if exists, can be used multiple times.

## EXAMPLE

**$ 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
```