Amazon Corretto Docker Image

Quick reference

• Maintained by:
  https://github.com/corretto/corretto-docker

• Where to get help:
  https://dockr.ly/comm-slack, Server Fault, https://unix.stackexchange.com/help/on-topic, or https://stackoverflow.com/help/on-topic

Supported tags and respective Dockerfile links

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/8/jdk/al2-generic/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/8/jdk/al2023/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/8/jre/al2023/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/8/jre/al2/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/8/jdk/al2/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/8/jdk/alpine/3.21/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/8/jre/alpine/3.21/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/8/jdk/alpine/3.22/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/8/jre/alpine/3.22/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/8/jdk/alpine/3.23/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/8/jre/alpine/3.23/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/8/jdk/alpine/3.24/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/8/jre/alpine/3.24/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/11/jdk/al2-generic/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/11/jdk/al2023/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/11/headless/al2023/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/11/headful/al2023/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/11/headless/al2/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/11/jdk/al2/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/11/jdk/alpine/3.21/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/11/jdk/alpine/3.22/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/11/jdk/alpine/3.23/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/11/jdk/alpine/3.24/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/17/jdk/al2-generic/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/17/jdk/al2023/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/17/headless/al2023/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/17/headful/al2023/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/17/headless/al2/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/17/headful/al2/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/17/jdk/al2/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/17/jdk/alpine/3.21/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/17/jdk/alpine/3.22/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/17/jdk/alpine/3.23/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/17/jdk/alpine/3.24/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/21/jdk/al2-generic/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/21/jdk/al2023/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/21/headless/al2023/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/21/headful/al2023/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/21/jdk/alpine/3.21/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/21/jdk/alpine/3.22/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/21/jdk/alpine/3.23/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/21/jdk/alpine/3.24/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/25/jdk/al2023/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/25/headless/al2023/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/25/headful/al2023/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/25/jdk/alpine/3.21/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/25/jdk/alpine/3.22/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/25/jdk/alpine/3.23/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/25/jdk/alpine/3.24/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/26/jdk/al2023/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/26/headless/al2023/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/26/headful/al2023/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/26/jdk/alpine/3.21/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/26/jdk/alpine/3.22/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/26/jdk/alpine/3.23/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/26/jdk/alpine/3.24/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/27/jdk/al2023/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/27/headless/al2023/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/27/headful/al2023/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/27/jdk/alpine/3.21/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/27/jdk/alpine/3.22/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/27/jdk/alpine/3.23/Dockerfile

• https://github.com/corretto/corretto-docker/blob/980e128b4f889e***b5e002334ff1ac1b99/27/jdk/alpine/3.24/Dockerfile

Quick reference (cont.)

• Where to file issues:
  https://github.com/corretto/corretto-docker/issues?q=is:issue+is:pr

• Supported architectures: (https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/amazoncorretto/, https://hub.docker.com/r/arm64v8/amazoncorretto/

• Published image artifact details:
  https://github.com/docker-library/repo-info/blob/master/repos/amazoncorretto (https://github.com/docker-library/repo-info/commits/master/repos/amazoncorretto)
  (image metadata, transfer size, etc)

• Image updates:
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Famazoncorretto
  https://github.com/docker-library/official-images/blob/master/library/amazoncorretto (https://github.com/docker-library/official-images/commits/master/library/amazoncorretto)

• Source of this description:
  https://github.com/docker-library/docs/tree/master/amazoncorretto (https://github.com/docker-library/docs/commits/master/amazoncorretto)

What is Amazon Corretto?

Corretto is a binary distribution of the Open Java Development Kit (OpenJDK) with long-term support from Amazon. Corretto is certified using the Java Technical Compatibility Kit (TCK) to ensure it meets the Java SE standard and is available on Linux, Windows, and macOS. It includes https://docs.aws.amazon.com/corretto/latest/corretto-8-ug/patches.html that have proven useful in running our own services.

Why should I use Corretto?

Corretto is a reliable binary distribution of OpenJDK with the assurance of long-term support provided at no cost to you. Amazon runs Corretto internally on thousands of production services. Every modification we make to Corretto fixes or mitigates a problem we found running OpenJDK. Amazon also plans to apply urgent fixes (including security) when they are available and ready to use, outside of the regular quarterly cycle.

How is Corretto different from OpenJDK?

Corretto is a distribution of Open JDK with patches included by Amazon that are not yet integrated in the corresponding OpenJDK update projects. We focus on patches that improve performance or stability in OpenJDK, chosen based on Amazon's observations running large services.

What kinds of patches does Amazon intend to include in Corretto?

Patches will include security fixes, performance enhancements (e.g., speeding up frequently used functions), garbage collection scheduling, and preventing out-of-memory situations, as well as improved monitoring, reporting, and thread management.

Is there any cost associated with using Corretto?

Corretto is distributed by Amazon under an Open Source license at no cost to you. It is licensed under the terms of the GNU Public License version 2 with the Class Path Exception (GPLv2 with CPE). Amazon does not charge for its use or distribution.

What is included in Corretto's long-term support?

Amazon will provide security updates for Corretto 8 until at least June 2023. Updates are planned to be released quarterly. Corretto 11, corresponding to OpenJDK 11, will be available during the first half of 2019. Amazon will support Corretto 11 with quarterly updates until at least August 2024.

Can I use Corretto as a drop-in replacement for other JDKs?

Corretto is designed as a drop-in replacement for all Java SE distributions unless you are using features (e.g., Java Flight Recorder) not available in OpenJDK. Once Corretto binaries are installed on a host and correctly invoked to run your Java applications (e.g., using the alternatives command on Linux), existing command-line options, tuning parameters, monitoring, and anything else in place will continue to work as before.

Why does security scanner show that a docker image has a CVE?

If a security scanner reports that an amazoncorretto image includes a CVE, the first recommended action is to pull an updated version of this image.

If no updated image is available, run the appropriate command to update packages for the platform, ie. run "apk -U upgrade" for Alpine or "yum update -y --security" for AmazonLinux in your Dockerfiles or systems to resolve the issue immediately.

If no updated package is available, please treat this as a potential security issue and follow https://aws.amazon.com/security/vulnerability-reporting/ or email AWS security directly at ***.

It is the responsibility of the base docker image supplier to provide timely security updates to images and packages. The amazoncorretto images are automatically rebuilt when a new base image is made available, but we do not make changes to our Dockerfiles to pull in one-off package updates. If a new base image has not yet been made generally available by a base docker image maintainer, please contact that maintainer to request that the issue be addressed.

Note that there are multiple reasons why a CVE may appear to be present in a docker image, as explained in the https://github.com/docker-library/faq/tree/73f10b0daf2fb8e7b38efaccc0e90b3510919d51#why-does-my-security-scanner-show-that-an-image-has-cves.

Image Variants

The amazoncorretto images come in many flavors, each designed for a specific use case.

amazoncorretto:<version>

This is the defacto image. If you are unsure about what your needs are, you probably want to use this one. It is designed to be used both as a throw away container (mount your source code and start the container to start your app), as well as the base to build other images off of.

amazoncorretto:<version>-alpine

This image is based on the popular [***] available in https://hub.docker.com/_/alpine. Alpine Linux is much smaller than most distribution base images (~5MB), and thus leads to much slimmer images in general.

This variant is useful when final image size being as small as possible is your primary concern. The main caveat to note is that it does use https://musl.libc.org instead of https://www.etalabs.net/compare_libcs.html, so software will often run into issues depending on the depth of their libc requirements/assumptions. See this Hacker News comment thread for more discussion of the issues that might arise and some pro/con comparisons of using Alpine-based images.

To minimize image size, it's uncommon for additional related tools (such as git or bash) to be included in Alpine-based images. Using this image as a base, add the things you need in your own Dockerfile (see the https://hub.docker.com/_/alpine/ for examples of how to install packages if you are unfamiliar).

License

Amazon Corretto is released under the same open source license as OpenJDK, which is licensed under the GNU Public License version 2 with the Class Path Exception (https://openjdk.java.net/legal/gplv2+ce.html).

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 https://github.com/docker-library/repo-info/tree/master/repos/amazoncorretto.

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.