AlmaLinux Bootable Container Base Images (bootc)

May 31, 2025 ยท View on GitHub

Caution: AlmaLinux bootc images are currently experimental. Please use with care and report any issues.

Available Pre-built Images

Official pre-built experimental images are available on Quay.io:

This project provides tooling to build experimental AlmaLinux bootable container images. These images leverage the bootc project, which enables the creation of bootable OS images from container images.

Our images are based on the work done for CentOS Bootc Base Images and utilize bootc-base-imagectl for their construction.

Project Status & News

  • [2024-09-02] AlmaLinux announces experimental bootc support and HeliumOS: Read the blog post
  • For the latest general information about AlmaLinux, visit almalinux.org.

Building Images (Advanced)

This repository uses make to build the images locally.

Prerequisites

  • make
  • A container runtime like podman or docker (ensure it's running and you have appropriate permissions).
  • Sufficient disk space and internet connectivity.

Build Instructions

The following examples demonstrate how to build specific variants:

Example: AlmaLinux OS Kitten 10

make \
  PLATFORM=linux/amd64 \
  IMAGE_NAME=almalinux-bootc \
  VERSION_MAJOR=10-kitten

Example: AlmaLinux OS 10 (x86_64-v2)

make \
  PLATFORM=linux/amd64/v2 \
  IMAGE_NAME=almalinux-bootc \
  VERSION_MAJOR=10-kitten

Example: AlmaLinux 9 (x86_64)

make \  
  PLATFORM=linux/amd64 \  
  IMAGE_NAME=almalinux-bootc \  
  VERSION_MAJOR=9

Explanation of Build Variables:

  • PLATFORM: Specifies the target architecture and variant (e.g., linux/amd64, linux/amd64/v2, linux/arm64).
  • IMAGE_NAME: The base name for the output container image. (e.g. almalinux-bootc)
  • VERSION_MAJOR: The AlmaLinux major version (e.g., 9, 10, 10-kitten).

Contributing and Community

We welcome contributions and feedback!
Join the discussion and get involved with the relevant AlmaLinux Special Interest Groups (SIGs):