bootc-switch - Man Page
Target a new container image reference to boot
Synopsis
bootc-switch [--quiet] [--transport] [--enforce-container-sigpolicy] [--ostree-remote] [--retain] [-h|--help] [-V|--version] <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`.
Options
- --quiet
Don't display progress
- --transport=TRANSPORT [default: registry]
The transport; e.g. oci, oci-archive. Defaults to `registry`
- --enforce-container-sigpolicy
This is the inverse of the previous `--target-no-signature-verification` (which is now a no-op).
Enabling this option enforces that `/etc/containers/policy.json` includes a default policy which requires signatures.
- --ostree-remote=OSTREE_REMOTE
Enable verification via an ostree remote
- --retain
Retain reference to currently booted image
- -h, --help
Print help (see a summary with '-h')
- -V, --version
Print version
- <TARGET>
Target image to use for the next boot
Version
v0.1.10