This repository contains the base container images for Amazon Linux on Docker Hub and Amazon Elastic Container Registry.

This is more of an artifact store than a Git repository, for reasons explained later. Please note that branches other than master are regularly force-pushed, and content may disappear without warning. For more reliable sources of Amazon Linux container images, use the Amazon Linux on-premises image download site, Docker Hub, or Amazon ECR.

The Docker Official Images program produces the top-level images available on Docker Hub, including the base OS images that serve as a starting point for most Docker users.

The images are maintained in the open. Image generation starts from a file in docker-library/official-images.git named library/amazonlinux. This file is machine-readable and connects image tags to a Git repository and commit.

During image build, the build system clones the referenced Git repository at a given commit and runs docker build in that directory. For application images, this usually involves downloading and installing software. For base OS images, this means adding the contents of a tarball as a single layer.

Amazon Linux is able to update our first-party sources (ECR) same-day as the associated AMI release. To reduce the operational load on the Docker Official Images program, we batch our OS releases and submit them weekly.