Getting Started with Amazon Corretto 17 on Docker Images
This topic describes how to build and launch a Docker image that uses Amazon Corretto 17. You must have the latest version of Docker installed.
Using the official image for Amazon Corretto 17.
Amazon Corretto 17 is available as an official image on Docker Hub
docker run amazoncorretto:17 java -versionOutput:
openjdk version "17.0.14" 2025-01-21 LTS OpenJDK Runtime Environment Corretto-17.0.14.7.1 (build 17.0.14+7-LTS) OpenJDK 64-Bit Server VM Corretto-17.0.14.7.1 (build 17.0.14+7-LTS, mixed mode, sharing)
Using the Corretto ECR Instance
Note
The Corretto ECR Private Registry located at
489478819445.dkr.ecr.us-west-2.amazonaws.com/amazoncorretto
is now deprecated. Please migrate existing usages to the
Corretto ECR Public Gallery.
To use the Corretto ECR instance, run the following commands:
docker pull public.ecr.aws/amazoncorretto/amazoncorretto:17
docker run -it public.ecr.aws/amazoncorretto/amazoncorretto:17 /bin/bashYou can see the list of available images by going here
Amazon Corretto on Alpine
Amazon Corretto on Alpine Linux images are available on
Amazon ECR Public Gallery
Using dockerhub
docker pull amazoncorretto:17-alpine-jdk
docker run -it amazoncorretto:17-alpine-jdk /bin/shBuild a Docker Image with Amazon Corretto 17
Run the following command to build an image that uses Amazon Corretto 17.
docker build -t amazon-corretto-17 github.com/corretto/corretto-docker#main:17/jdk/al2023After the command completes, you have an image called amazon-corretto-17.
To launch this image locally, run the following command.
docker run -it amazon-corretto-17You can also push this image to Amazon ECR. See the Pushing an Image topic in the Amazon Elastic Container Registry User Guide for details.
Create an
Image
You can create a new Docker image using
Corretto's official Docker Hub image
-
Create a Dockerfile with the following content.
FROM amazoncorretto:17 RUN echo $' \ public class Hello { \ public static void main(String[] args) { \ System.out.println("Welcome to Amazon Corretto!"); \ } \ }' > Hello.java RUN javac Hello.java CMD ["java", "Hello"] -
Build the new image.
docker build -t hello-app . -
Run the new image.
docker run hello-appYou get the following output.
Welcome to Amazon Corretto!
