Switch the container image reference

You can change the container image reference used for upgrades by using the bootc switch command. For example, you can switch from the stage to the production tag. To manually switch an existing ostree-based container image reference, use the bootc switch command.

Before you begin

  • A booted system using bootc.

Procedure

Run the following command: 
$ sudo bootc switch [--apply] quay.io/<namespace>/<image>:<tag>

Optionally, you can use the --apply option when you want to automatically take actions, such as rebooting if the system has changed.

Note
The bootc switch command has the same effect as bootc upgrade. The only difference is the container image reference is changed. This enables preserving the existing states in /etc and /var, for example, host SSH keys and home directories.