NAME
bootc-upgrade - Download and queue an updated container image to apply
SYNOPSIS
bootc upgrade [OPTIONS...]
DESCRIPTION
Download and queue an updated container image to apply.
This does not affect the running system; updates operate in an "A/B" style by default.
A queued update is visible as staged in bootc status.
Checking for Updates
The --check option allows you to verify if updates are available without downloading the full image layers. This only downloads the updated manifest and image configuration (typically kilobyte-sized metadata), making it much faster than a full upgrade.
Applying Updates
Currently by default, the update will be applied at shutdown time via ostree-finalize-staged.service.
There is also an explicit bootc upgrade --apply verb which will automatically take action (rebooting)
if the system has changed.
However, in the future this is likely to change such that reboots outside of a bootc upgrade --apply
do not automatically apply the update in addition.
Soft Reboot
For shared --apply and --soft-reboot behavior, see
Soft reboots.
OPTIONS
--quiet
Don't display progress
--check
Check if an update is available without applying it
--apply
Restart or reboot into the new target image
--soft-reboot=SOFT_REBOOT
Configure soft reboot behavior
Possible values:
- required
- auto
--download-only
Download and stage the update without applying it
--from-downloaded
Apply a staged deployment that was previously downloaded with --download-only
--tag=TAG
Upgrade to a different tag of the currently booted image
--from-delta=PATH
Upgrade from 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
Check for available updates:
bootc upgrade --check
Upgrade and immediately apply the changes:
bootc upgrade --apply
Upgrade with soft reboot if possible:
bootc upgrade --apply --soft-reboot=auto
Upgrade to a different tag:
bootc upgrade --tag v1.2
Check if a specific tag has updates before applying:
bootc upgrade --tag prod --check
Upgrade to a tag and immediately apply:
bootc upgrade --tag v2.0 --apply
SEE ALSO
bootc(8), bootc-switch(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.