Updates and rollback

Kleinia ships as an OCI image. An update downloads a new image and prepares it next to the running one. The new version takes effect on the next boot. If the update fails, nothing changes. See An image-based system.

Check the current state

sudo bootc status

This shows the image you are running, its version, and the deployment you would roll back to.

Update

sudo bootc upgrade
systemctl reboot

To only check whether an update is available, use sudo bootc upgrade --check.

Roll back

If something is wrong after an update, boot the previous deployment:

sudo bootc rollback
systemctl reboot

You can also choose the previous deployment from the boot menu, which is useful if the new version does not start at all.

Switch to another release

sudo bootc switch ghcr.io/kleinia-os/kleinia:<tag>
systemctl reboot

The tags available will be listed in the release notes, published on kleinia.io with each release.

Applications and your files

Flatpak applications and everything in /home and /var are separate from the system image. Updates and rollbacks don’t touch them. Update Flatpak apps with flatpak update or in GNOME Software.