Announcing the new Certification Program, run by the Certification SIG. Read More

Bringing bootc to AlmaLinux

profile
Isaac Beverly

Developer, HeliumOS

bootc is a new deployment method that powers Image mode for RHEL and HeliumOS, a new Linux distribution. We are excited to announce that AlmaLinux now offers bootc images for Intel/AMD(x86_64) and ARM64(AArch4).

How did this start?

My goal as developer of HeliumOS is to produce a Linux-based desktop operating system that is user-friendly, stable, and reliable. The first foray towards this goal used a Debian base, however this had some issues:

  • Debian has 3-5 years of support. Though stable relative to most Linux distributions, I wanted more stability.
  • An unexpected interruption during a traditional Linux package manager update can render the system un-bootable or otherwise broken.

2 months ago, I learned of Image mode for RHEL, a new method of deploying RHEL that used OCI images for updates. Rebasing on Enterprise Linux and using bootc, the technology behind Image mode for RHEL would solve both of the issues that I found with Debian. After various experiments, HeliumOS announced an Alpha release based on CentOS Stream.

Despite solving several issues, rebasing on CentOS Stream introduced new problems:

  • CentOS Stream has a minor-rolling release schedule. This meant that Nvidia drivers and other software that require a specific version of the Linux kernel would be more difficult to distribute.
  • CentOS Stream only has 5 years of support. This may be acceptable for some usage, but limits HeliumOS usage in other environments with longer lifecycle requirements.

A small hop to a minor-stable Enterprise Linux distribution such as AlmaLinux would resolve both issues.

Through collaboration with the AlmaLinux Virt and Container SIG, and with help from the Fedora bootc chat, we have setup workflows to produce AlmaLinux bootc images. Updates and new releases to HeliumOS going forward will be delivered through bootc images derived from AlmaLinux.

What are OCI containers and images?

OCI containers provide an isolated environment running on a container runtime such as Podman or containerd(Docker). Software deployed via a typical OCI container will use the host system’s kernel and a portable environment delivered via an OCI image.

Deployment of software via OCI images is especially useful because application dependencies are resolved during image build. OCI containers can be built and deployed to any system with an OCI container runtime without the deployed system needing to be concerned with dependency resolution.

What are atomic Linux distributions?

Atomic operations execute as a single unit. When applied to Linux distributions, updates either successfully update the system, or completely fail, with no intermediate state. There are many implementations of this system: Fedora Silverblue using rpm-ostree, VanillaOS using ABRoot, openSUSE MicroOS using BTRFS snapshots, even Android using GKI+Modules.

What is bootc?

bootc is a tool that uses bootc-compatible OCI images and OSTree to deploy updates to a Linux system in an atomic fashion. By bundling the Linux kernel and other essential components within an OCI image with the proper SELinux configuration, the image’s root file system becomes more suitable for booting. On the deployment system, bootc maps the OCI image to a format compatible with OSTree. OSTree then treats the image as any other OSTree commit. After a reboot, the system automatically reboots into the new update. The bootloader also offers an option to rollback to a previous image. Distributions can use bootc to provide atomic updates with the convenience of existing OCI infrastructure and tooling.

Using AlmaLinux bootc images

Building a bootc image is very similar to building a typical OCI image. As an example, let’s create a bootc image derived from AlmaLinux 9.4 that serves static content using Apache httpd.

FROM quay.io/almalinuxorg/almalinux-bootc:9.4

# Install the RPM package and enable the systemd service for httpd:
RUN dnf install -y httpd
RUN systemctl enable httpd

# Configure httpd to serve content from the image:
RUN mv /var/www /usr/share/www
RUN sed -ie 's,/var/www,/usr/share/www,' /etc/httpd/conf/httpd.conf
RUN rm -rdf /usr/share/httpd/noindex

# Add "hello world" page to image:
RUN echo "<h1>Hello world!</h1>" > /usr/share/www/html/index.html

Build the image and push it to the OCI registry of your choice:

podman build -t almalinux-httpd .

podman push almalinux-httpd <YOUR REGISTRY HERE>

With Anaconda, bootc install to-existing-root, or bootc-image-builder, you can deploy the image to a bare-metal system or virtual machine. The deployed system will automatically check the OCI registry for updates to the image and reboot if needed. This image can also be run as a container using podman run -p 8000:80 localhost/almalinux-httpd.

What’s next?

Development continues, from Nvidia driver support in HeliumOS, to distribution-agnostic tools such as bootc-gtk. As a downstream project, HeliumOS is looking forward to a collaborative relationship with AlmaLinux. A stable release of HeliumOS based on AlmaLinux 10 is planned for 2025. If you have any questions or would like to contact me for other reasons, you can find me in the HeliumOS Matrix Space, AlmaLinux Mattermost Server, or Fedora bootc Matrix Room.

Stay updated!