AlmaLinux OS

AlmaLinux OS is an Open Source and forever-free enterprise Linux distribution, governed and driven by the community, focused on long-term stability and a robust production-grade platform. AlmaLinux OS is 1:1 binary compatible with RHEL® 8 and it was founded by the team behind the well-established CloudLinux OS.

AlmaLinux Container/Docker Images

This project contains sources and tools for building Official AlmaLinux Images images in dockerhub and Quay.io repos.

Local development

The branch main contains the sources to create all images. Make sure to use --single-branch with --depth=1 for any local development. Otherwise, git will clone all branches, which would be unnecessary. Check Build Requirements below for more details

git clone --single-branch --branch=main --depth=1  https://github.com/AlmaLinux/docker-images.git

About this image

AlmaLinux OS images can be use with all OCI complaint container runtime environments like Docker, Podman and Kubernetes and serve as drop-in replacemenets for centos images as it reaches End of Life.

Platform image, latest tag

The default (platform) image is a general-purpose image with a full DNF stack and basic tools like bintools, find, tar, minimal-vim, etc.

The almalinux:latest tag will always point to the latest stable release of the default image. Major releases and minor releases are also tagged with their version (e.g. almalinux:8, almalinux:8.6, almalinux:9, and almalinux:9.0 etc).

Minimal image, minimal tag

The minimal image is a stripped-down image that uses the microdnf as package manager which uses libdnf and hence doesn't require Python. This image is 52% smaller in size (37MB download, 102MB expanded), contains a very limited package set. It is designed for applications that come with their own dependencies bundled (e.g. GO, NodeJS, Java).

The almalinux:minimal tag will always point to the latest stable release of the default image. Major releases and minor releases are also tagged with their version (e.g. almalinux:8-minimal, almalinux:8.6-minimal, almalinux:9-minimal, and almalinux:9.0-minimal etc).

UBI8 variant images

AlmaLinux OS now offers new variant of images almalinux/8-base, almalinux/8-init, almalinux/8-micro and almalinux/8-minimal to be aligned with RedHat UBI images.

UBI9 variant images

AlmaLinux OS now offers new variant of images almalinux/9-base, almalinux/9-init, almalinux/9-micro and almalinux/9-minimal to be aligned with RedHat UBI9 images.

Upgrade policy

All images for supported releases will be updated monthly or as needed for security fixes.

Build Requirements

Container/Docker images are created using Dockerfiles located dockerfiles folder. Build tool requires docker or podman along with jq. These images can be further customized by editing source files.

Basic knowledge of working with docker or podman is required. Most commands below docker can be replaced with podman.

Building Images

Use command below to build AlmaLinux 8, default image.

docker build -t almalinux-8 -f dockerfiles/al8/Dockerfile.default .

References

• Docker documentaion - Create a base image
• Opencontainers image-spec annotations/labels
• RedHat Kickstart Reference guide

License

Licensed under the MIT license, see the LICENSE file for details.