⚠️ This repository is outdated. AlmaLinux Docker/Container images scripts and workflows are now located in the container-images repository. All issues and pull requests must be created to the new repository.
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.
This project contains sources and tools for building Official AlmaLinux Images images in dockerhub and Quay.io repos.
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.gitAlmaLinux 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.
latest tagThe 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 tagThe 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).
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.
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.
All images for supported releases will be updated monthly or as needed for security fixes.
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.
Use command below to build AlmaLinux 8, default image.
docker build -t almalinux-8 -f dockerfiles/al8/Dockerfile.default .Licensed under the MIT license, see the LICENSE file for details.