Skip to content

Working with the image

System image management, updates, and version rollback.

Updating the system

ALT Atomic updates occur atomically via apm:

bash
apm system image update

After updating, you need to reboot the system:

bash
sudo reboot

Displaying current image

bash
apm system image status

Displaying history of image changes

bash
apm system image history

Rolling back to previous versions

In case a problem occurs, you can roll back to any previous version of the system via GRUB at boot.

  1. Reboot the system
  2. In the GRUB menu, select the previous version you want to rollback to
  3. The system will boot from the previous image

Switching to other images

You can switch to another compatible OCI image:

bash
sudo bootc switch <registry>/:<tag></tag></registry>

Configuring the image

If necessary, declarative image composition changes, such as package installation, kernel swapping and systemd reconfiguration, can be achieved via editing /etc/apm/image.yml file and executing apm system image apply.

Details and examples: "Image configuration". For complete module references, see "Configuring the APM build".

Released under the GPL-3.0+ license. Content is available under the CC BY-SA 4.0 license, unless otherwise stated.