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.