amazonlinux Docker official image overview

⁠DEPRECATION NOTICE

The 1, 2018.03, and 2018.03.0.20231218.0 tags of this image are EOL (December 31, 2023⁠ / docker-library/official-images#22075⁠, although the last meaningful update was December 18, 2023). Please migrate to amazonlinux:2023. See the AL2023 migration guide⁠ for details.

⁠Quick reference

• Maintained by:
  the Amazon Linux Team⁠

• Where to get help:
  the Docker Community Slack⁠, Server Fault⁠, Unix & Linux⁠, or Stack Overflow⁠

⁠Supported tags and respective Dockerfile links

• 2023, latest, 2023.12.20260817.0⁠

• 2, 2.0.20260817.0⁠

⁠Quick reference (cont.)

• Where to file issues:

  • amazonlinux/container-images/issues⁠
  • the Amazon Linux forums⁠

• Supported architectures: (more info⁠)
  amd64⁠, arm64v8⁠

• Published image artifact details:
  repo-info repo's repos/amazonlinux/ directory⁠ (history⁠)
  (image metadata, transfer size, etc)

• Image updates:
  official-images repo's library/amazonlinux label⁠
  official-images repo's library/amazonlinux file⁠ (history⁠)

• Source of this description:
  docs repo's amazonlinux/ directory⁠ (history⁠)

⁠What is Amazon Linux?

Amazon Linux is provided by Amazon Web Services (AWS). It is designed to provide a stable, secure, and high-performance execution environment for applications running on Amazon EC2. The full distribution includes packages that enable easy integration with AWS, including launch configuration tools and many popular AWS libraries and tools. AWS provides ongoing security and maintenance updates to all instances running Amazon Linux.

The Amazon Linux container image contains a minimal set of packages. To install additional packages, use dnf⁠.

Supported major versions of Amazon Linux:

• Amazon Linux 2023⁠ (recommended, latest)

Amazon Linux 2 reached end of life on June 30, 2026 (see AL2 FAQs⁠). Amazon Linux AMI (AL1) reached end of life on December 31, 2023. Please migrate to Amazon Linux 2023.

For information on security updates for Amazon Linux, please refer to:

• Amazon Linux 2023 Security Advisories⁠

Note that Docker Hub's vulnerability scanning for Amazon Linux is currently based on RPM versions, which does not reflect the state of backported patches for vulnerabilities.

⁠What is Amazon Linux 2023?

• Amazon Linux 2023: https://aws.amazon.com/linux/amazon-linux-2023/⁠
• 2023 Release Notes: https://docs.aws.amazon.com/linux/al2023/release-notes/relnotes.html⁠
• FAQs: https://aws.amazon.com/linux/amazon-linux-2023/faqs/⁠
• What's New: https://aws.amazon.com/about-aws/whats-new/2023/03/amazon-linux-2023/⁠
• User Guide: https://docs.aws.amazon.com/linux/al2023/ug/what-is-amazon-linux.html⁠

⁠Where can I run Amazon Linux container images?

You can run Amazon Linux container images in any Docker based environment. Examples include, your laptop, in AWS EC2 instances, and ECS clusters.

⁠What packages are available in the Amazon Linux containers?

Amazon Linux Docker container images contain a subset of the packages in the images for use on EC2 and as VMs in on-premises scenarios. The container images can be configured to use any of the full set of packages in images for EC2 and on-premises use.

⁠Will updates be available for Amazon Linux containers?

Similar to the Amazon Linux images for AWS EC2 and on-premises use, Amazon Linux container images will get ongoing updates from Amazon in the form of security updates, bug fix updates, and other enhancements. Security bulletins for Amazon Linux are available at https://alas.aws.amazon.com/⁠

⁠What support is available for Amazon Linux outside AWS?

• GitHub Issues: https://github.com/amazonlinux/amazon-linux-2023/issues⁠
• Documentation: https://docs.aws.amazon.com/linux/⁠
• Paid Support from AWS: https://aws.amazon.com/premiumsupport/⁠

⁠Will AWS support the current versions of Amazon Linux going forward?

Yes; Amazon Linux 2023 receives ongoing security and maintenance updates. Amazon Linux 2 reached end of life on June 30, 2026, and Amazon Linux AMI (AL1) reached end of life on December 31, 2023. Please migrate to Amazon Linux 2023.

⁠FAQs

⁠Amazon Linux 2023

• FAQs: https://aws.amazon.com/linux/amazon-linux-2023/faqs/⁠

⁠License

Amazon Linux is available under the GNU General Public License, version 2.0⁠. Individual software packages are available under their own licenses; run rpm -qi [package name] or check /usr/share/doc/[package name]-* and /usr/share/licenses/[package name]-* for details.

As with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).

Some additional license information which was able to be auto-detected might be found in the repo-info repository's amazonlinux/ directory⁠.

As for any pre-built image usage, it is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.