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.git
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.
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).
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).
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 .
- Docker documentaion - Create a base image
- Opencontainers image-spec annotations/labels
- RedHat Kickstart Reference guide
Licensed under the MIT license, see the LICENSE file for details.