library/adoptopenjdk

DEPRECATION NOTICE

This image is officially deprecated in favor of https://hub.docker.com/_/eclipse-temurin/, and will receive no further updates after 2021-08-01 (Aug 01, 2021). Please adjust your usage accordingly.

Quick reference

• Maintained by:
  https://github.com/AdoptOpenJDK/openjdk-docker

• Where to get help:
  AdoptOpenJDK Slack; https://mail.openjdk.java.net/mailman/listinfo/adoption-discuss; https://www.eclipse.org/openj9/oj9_joinslack.html; https://dev.eclipse.org/mailman/listinfo/openj9-dev

Supported tags and respective Dockerfile links

Note: the description for this image is longer than the Hub length limit of 25000, so the "Supported tags" list has been trimmed to compensate. See https://github.com/docker/hub-beta-feedback/issues/238 for more information.

• See https://github.com/docker-library/docs/tree/master/adoptopenjdk/README.md#supported-tags-and-respective-dockerfile-links

Quick reference (cont.)

• Where to file issues:
  https://github.com/AdoptOpenJDK/openjdk-docker/issues; The adoptopenjdk support page has more information on quality, roadmap and support levels for AdoptOpenJDK builds;

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

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

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

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

Overview

The images in this repository contain OpenJDK ***aries that are built by AdoptOpenJDK and contain both HotSpot and Eclipse OpenJ9 JVMs.

What is AdoptOpenJDK ?

AdoptOpenJDK is a community of Java™ user group members, Java developers and vendors who are advocates of OpenJDK, the open source project which forms the basis of the Java programming language and platform. AdoptOpenJDK provides prebuilt OpenJDK ***aries from a fully open source set of build scripts and infrastructure. AdoptOpenJDK builds and tests ***aries for different source code streams based upon OpenJDK. Our ***aries undergo extensive testing, and the Releases have passed all the available OpenJDK test suites and our additional tests (donated by the community), ensuring the best quality ***ary available.

Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates.

!https://raw.githubusercontent.com/docker-library/docs/0db0af87e256d941bf011e3b5b06ca4a8edb6b84/adoptopenjdk/logo.png

What is Eclipse OpenJ9 ?

https://www.eclipse.org/openj9/ is a high performance, scalable, Java virtual machine (JVM) implementation that has a proven track record of running Java applications in production environments. Contributed to the Eclipse project by IBM, the OpenJ9 JVM underpins the IBM SDK, Java Technology Edition product that is a core component of many IBM Enterprise software products. Continued development of OpenJ9 at the Eclipse foundation ensures wider collaboration, fresh innovation, and the opportunity to influence the development of OpenJ9 for the next generation of Java applications. OpenJDK ***aries that include Eclipse OpenJ9 are available through AdoptOpenJDK.

Images

There are two types of Docker images here: the Java Development Kit (JDK) and the Java Runtime Environment (JRE). These images can be used as the basis for custom built images for running your applications.

Multi-Arch Image

Docker Images for the following architectures are now available:

• HotSpot
  • amd64, arm32v7, arm64v8, ppc64le, s390x, windows-amd64
• Eclipse OpenJ9
  • amd64, ppc64le, s390x, windows-amd64

How to use this Image

To run a pre-built jar file with the latest OpenJDK 11 with HotSpot JRE image, use the following Dockerfile:

dockerfile
FROM adoptopenjdk:11-jre-hotspot
RUN mkdir /opt/app
COPY japp.jar /opt/app
CMD ["java", "-jar", "/opt/app/japp.jar"]

To do the same with the latest OpenJDK 11 with Eclipse OpenJ9 JRE image, use the following Dockerfile:

dockerfile
FROM adoptopenjdk:11-jre-openj9
RUN mkdir /opt/app
COPY japp.jar /opt/app
CMD ["java", "-jar", "/opt/app/japp.jar"]

You can build and run the Docker Image as shown in the following example:

console
docker build -t japp .
docker run -it --rm japp

If you want to place the jar file on the host file system instead of inside the container, you can mount the host path onto the container by using the following commands:

dockerfile
FROM adoptopenjdk:12.0.1_12-jdk-openj9-0.14.1
CMD ["java", "-jar", "/opt/app/japp.jar"]

console
docker build -t japp .
docker run -it -v /path/on/host/system/jars:/opt/app japp

Image Variants

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

adoptopenjdk:<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.

Some of these tags may have names like focal in them. These are the suite code names for releases of https://wiki.ubuntu.com/Releases and indicate which release the image is based on. If your image needs to install any additional packages beyond what comes with the image, you'll likely want to specify one of these explicitly to minimize breakage when there are new releases of Ubuntu.

adoptopenjdk:<version>-windowsservercore

This image is based on https://hub.docker.com/r/microsoft/windowsservercore/. As such, it only works in places which that image does, such as Windows 10 Professional/Enterprise (Anniversary Edition) or Windows Server 2016.

For information about how to get Docker running on Windows, please see the relevant "Quick Start" guide provided by Microsoft:

• Windows Server Quick Start
• Windows 10 Quick Start

License

The Dockerfiles and associated scripts are licensed under the http://www.apache.org/licenses/LICENSE-2.0.html.

Licenses for the products installed within the images:

• Eclipse OpenJ9 + OpenJDK: The com***ed works license is http://openjdk.java.net/legal/gplv2+ce.html.
• OpenJDK: The project license is GNU GPL v2 with Classpath Exception.

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/adoptopenjdk.

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.