Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

NAME

bootc-switch - Target a new container image reference to boot

SYNOPSIS

bootc switch [OPTIONS...] <TARGET>

DESCRIPTION

Target a new container image reference to boot.

This is almost exactly the same operation as upgrade, but additionally changes the container image reference instead.

Usage

A common pattern is to have a management agent control operating system updates via container image tags; for example, quay.io/exampleos/someuser:v1.0 and quay.io/exampleos/someuser:v1.1 where some machines are tracking :v1.0, and as a rollout progresses, machines can be switched to v:1.1.

It is also supported to provide explicit digests, via e.g. bootc switch quay.io/exampleos/someuser@sha256:9cca0703342e24806a9f64e08c053dca7f2cd90f10529af8ea872afb0a0c77d4. When you do this, bootc upgrade will always be a no-op. In this model, upgrades are then always triggered by further switch operations.

Applying Changes

The --apply option will automatically restart the system if it has changed after switching to the new image.

Soft Reboot

For shared --apply and --soft-reboot behavior, see Soft reboots.

OPTIONS

TARGET

Target image to use for the next boot. Required unless `--from-downloaded` is present

--quiet

Don't display progress

--apply

Restart or reboot into the new target image

--soft-reboot=SOFT_REBOOT

Configure soft reboot behavior

Possible values:
- required
- auto

--transport=TRANSPORT

The transport; e.g. registry, oci, oci-archive, docker-daemon, containers-storage.  Defaults to `registry`

Default: registry

--download-only

Download and stage the update without applying it

--from-downloaded

Apply a staged deployment that was previously downloaded with --download-only

--enforce-container-sigpolicy

This is the inverse of the previous `--target-no-signature-verification` (which is now a no-op)

--retain

Retain reference to currently booted image

--from-delta=PATH

Switch using a local oci-delta artifact instead of the network

--uki-addon=SCOPED

Experimental. Name of the local/scoped UKI addons to install without the ".addon.efi" suffix. This option can be provided multiple times if multiple addons are to be installed (composefs backend only). On upgrade and switch, scoped addons already installed are carried forward; passing this flag adds further addons on top

--global-uki-addon=GLOBAL

Experimental. Name of the global UKI addons to install without the ".addon.efi" suffix. This option can be provided multiple times if multiple addons are to be installed (composefs backend only). On upgrade and switch, global addons already installed are carried forward; passing this flag adds further addons on top

EXAMPLES

Switch to a different image version:

bootc switch quay.io/exampleos/myapp:v1.1

Switch and immediately apply the changes:

bootc switch --apply quay.io/exampleos/myapp:v1.1

Switch with soft reboot if possible:

bootc switch --apply --soft-reboot=auto quay.io/exampleos/myapp:v1.1

SEE ALSO

bootc(8), bootc-upgrade(8), bootc-status(8), bootc-rollback(8)

VERSION


The Linux Foundation® (TLF) has registered trademarks and uses trademarks. For a list of TLF trademarks, see Trademark Usage.