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-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.