Official vs Non-Official Docker images
AdoptOpenJDK provides docker images in two different DockerHub repos
DockerHub maintained images (aka official DockerHub images) at this link .
AdoptOpenJDK maintained images (this repo).
Both images use the same underlying Java binaries from AdoptOpenJDK, but they support different OS flavours as below. Also the official DockerHub images are updated for underlying OS updates as and when the OS fixes are available. The AdoptOpenJDK maintained images are rebuilt everyday.
See Official Docker Images for the regular jdk and jre images based on Ubuntu and Windows.
Use this repo for Alpine, CentOS, ClefOS, Debian, Debian-Slim, UBI and UBI-Minimal based images as well as Slim images for all supported OSes.
Supported tags and respective Dockerfile links
Release Builds
alpine, jdk8u292-b10_openj9-0.26.0-alpine, x86_64-alpine-jdk8u292-b10_openj9-0.26.0, (8/jdk/alpine/Dockerfile.openj9.releases.full )
alpine-slim, jdk8u292-b10_openj9-0.26.0-alpine-slim, x86_64-alpine-jdk8u292-b10_openj9-0.26.0-slim, (8/jdk/alpine/Dockerfile.openj9.releases.slim )
alpine-jre, jre8u292-b10_openj9-0.26.0-alpine, x86_64-alpine-jre8u292-b10_openj9-0.26.0, (8/jre/alpine/Dockerfile.openj9.releases.full )
centos, jdk8u292-b10_openj9-0.26.0-centos, ppc64le-centos-jdk8u292-b10_openj9-0.26.0, x86_64-centos-jdk8u292-b10_openj9-0.26.0, (8/jdk/centos/Dockerfile.openj9.releases.full )
centos-slim, jdk8u292-b10_openj9-0.26.0-centos-slim, ppc64le-centos-jdk8u292-b10_openj9-0.26.0-slim, x86_64-centos-jdk8u292-b10_openj9-0.26.0-slim, (8/jdk/centos/Dockerfile.openj9.releases.slim )
centos-jre, jre8u292-b10_openj9-0.26.0-centos, ppc64le-centos-jre8u292-b10_openj9-0.26.0, x86_64-centos-jre8u292-b10_openj9-0.26.0, (8/jre/centos/Dockerfile.openj9.releases.full )
clefos, jdk8u292-b10_openj9-0.26.0-clefos, s390x-clefos-jdk8u292-b10_openj9-0.26.0, (8/jdk/clefos/Dockerfile.openj9.releases.full )
clefos-slim, jdk8u292-b10_openj9-0.26.0-clefos-slim, s390x-clefos-jdk8u292-b10_openj9-0.26.0-slim, (8/jdk/clefos/Dockerfile.openj9.releases.slim )
clefos-jre, jre8u292-b10_openj9-0.26.0-clefos, s390x-clefos-jre8u292-b10_openj9-0.26.0, (8/jre/clefos/Dockerfile.openj9.releases.full )
debian, jdk8u292-b10_openj9-0.26.0-debian, ppc64le-debian-jdk8u292-b10_openj9-0.26.0, s390x-debian-jdk8u292-b10_openj9-0.26.0, x86_64-debian-jdk8u292-b10_openj9-0.26.0, (8/jdk/debian/Dockerfile.openj9.releases.full )
debian-slim, jdk8u292-b10_openj9-0.26.0-debian-slim, ppc64le-debian-jdk8u292-b10_openj9-0.26.0-slim, s390x-debian-jdk8u292-b10_openj9-0.26.0-slim, x86_64-debian-jdk8u292-b10_openj9-0.26.0-slim, (8/jdk/debian/Dockerfile.openj9.releases.slim )
debian-jre, jre8u292-b10_openj9-0.26.0-debian, ppc64le-debian-jre8u292-b10_openj9-0.26.0, s390x-debian-jre8u292-b10_openj9-0.26.0, x86_64-debian-jre8u292-b10_openj9-0.26.0, (8/jre/debian/Dockerfile.openj9.releases.full )
debianslim, jdk8u292-b10_openj9-0.26.0-debianslim, ppc64le-debianslim-jdk8u292-b10_openj9-0.26.0, s390x-debianslim-jdk8u292-b10_openj9-0.26.0, x86_64-debianslim-jdk8u292-b10_openj9-0.26.0, (8/jdk/debianslim/Dockerfile.openj9.releases.full )
debianslim-slim, jdk8u292-b10_openj9-0.26.0-debianslim-slim, ppc64le-debianslim-jdk8u292-b10_openj9-0.26.0-slim, s390x-debianslim-jdk8u292-b10_openj9-0.26.0-slim, x86_64-debianslim-jdk8u292-b10_openj9-0.26.0-slim, (8/jdk/debianslim/Dockerfile.openj9.releases.slim )
debianslim-jre, jre8u292-b10_openj9-0.26.0-debianslim, ppc64le-debianslim-jre8u292-b10_openj9-0.26.0, s390x-debianslim-jre8u292-b10_openj9-0.26.0, x86_64-debianslim-jre8u292-b10_openj9-0.26.0, (8/jre/debianslim/Dockerfile.openj9.releases.full )
leap, jdk8u292-b10_openj9-0.26.0-leap, ppc64le-leap-jdk8u292-b10_openj9-0.26.0, x86_64-leap-jdk8u292-b10_openj9-0.26.0, (8/jdk/leap/Dockerfile.openj9.releases.full )
leap-jre, jre8u292-b10_openj9-0.26.0-leap, ppc64le-leap-jre8u292-b10_openj9-0.26.0, x86_64-leap-jre8u292-b10_openj9-0.26.0, (8/jre/leap/Dockerfile.openj9.releases.full )
tumbleweed, jdk8u292-b10_openj9-0.26.0-tumbleweed, ppc64le-tumbleweed-jdk8u292-b10_openj9-0.26.0, s390x-tumbleweed-jdk8u292-b10_openj9-0.26.0, x86_64-tumbleweed-jdk8u292-b10_openj9-0.26.0, (8/jdk/tumbleweed/Dockerfile.openj9.releases.full )
tumbleweed-jre, jre8u292-b10_openj9-0.26.0-tumbleweed, ppc64le-tumbleweed-jre8u292-b10_openj9-0.26.0, s390x-tumbleweed-jre8u292-b10_openj9-0.26.0, x86_64-tumbleweed-jre8u292-b10_openj9-0.26.0, (8/jre/tumbleweed/Dockerfile.openj9.releases.full )
ubi, jdk8u292-b10_openj9-0.26.0-ubi, ppc64le-ubi-jdk8u292-b10_openj9-0.26.0, s390x-ubi-jdk8u292-b10_openj9-0.26.0, x86_64-ubi-jdk8u292-b10_openj9-0.26.0, (8/jdk/ubi/Dockerfile.openj9.releases.full )
ubi-slim, jdk8u292-b10_openj9-0.26.0-ubi-slim, ppc64le-ubi-jdk8u292-b10_openj9-0.26.0-slim, s390x-ubi-jdk8u292-b10_openj9-0.26.0-slim, x86_64-ubi-jdk8u292-b10_openj9-0.26.0-slim, (8/jdk/ubi/Dockerfile.openj9.releases.slim )
ubi-jre, jre8u292-b10_openj9-0.26.0-ubi, ppc64le-ubi-jre8u292-b10_openj9-0.26.0, s390x-ubi-jre8u292-b10_openj9-0.26.0, x86_64-ubi-jre8u292-b10_openj9-0.26.0, (8/jre/ubi/Dockerfile.openj9.releases.full )
ubi-minimal, jdk8u292-b10_openj9-0.26.0-ubi-minimal, ppc64le-ubi-minimal-jdk8u292-b10_openj9-0.26.0, s390x-ubi-minimal-jdk8u292-b10_openj9-0.26.0, x86_64-ubi-minimal-jdk8u292-b10_openj9-0.26.0, (8/jdk/ubi-minimal/Dockerfile.openj9.releases.full )
ubi-minimal-jre, jre8u292-b10_openj9-0.26.0-ubi-minimal, ppc64le-ubi-minimal-jre8u292-b10_openj9-0.26.0, s390x-ubi-minimal-jre8u292-b10_openj9-0.26.0, x86_64-ubi-minimal-jre8u292-b10_openj9-0.26.0, (8/jre/ubi-minimal/Dockerfile.openj9.releases.full )
latest, jdk8u292-b10_openj9-0.26.0, ppc64le-ubuntu-jdk8u292-b10_openj9-0.26.0, s390x-ubuntu-jdk8u292-b10_openj9-0.26.0, x86_64-ubuntu-jdk8u292-b10_openj9-0.26.0, (8/jdk/ubuntu/Dockerfile.openj9.releases.full )
slim, jdk8u292-b10_openj9-0.26.0-slim, jdk8u292-b10_openj9-0.26.0-ubuntu-slim, ppc64le-ubuntu-jdk8u292-b10_openj9-0.26.0-slim, s390x-ubuntu-jdk8u292-b10_openj9-0.26.0-slim, x86_64-ubuntu-jdk8u292-b10_openj9-0.26.0-slim, (8/jdk/ubuntu/Dockerfile.openj9.releases.slim )
jre, jre8u292-b10_openj9-0.26.0, ppc64le-ubuntu-jre8u292-b10_openj9-0.26.0, s390x-ubuntu-jre8u292-b10_openj9-0.26.0, x86_64-ubuntu-jre8u292-b10_openj9-0.26.0, (8/jre/ubuntu/Dockerfile.openj9.releases.full )
Nightly Builds
alpine-nightly, jdk8u-alpine-nightly, x86_64-alpine-jdk8u-nightly, (8/jdk/alpine/Dockerfile.openj9.nightly.full )
alpine-nightly-slim, jdk8u-alpine-nightly-slim, x86_64-alpine-jdk8u-nightly-slim, (8/jdk/alpine/Dockerfile.openj9.nightly.slim )
alpine-jre-nightly, jre8u-alpine-nightly, x86_64-alpine-jre8u-nightly, (8/jre/alpine/Dockerfile.openj9.nightly.full )
centos-nightly, jdk8u-centos-nightly, ppc64le-centos-jdk8u-nightly, x86_64-centos-jdk8u-nightly, (8/jdk/centos/Dockerfile.openj9.nightly.full )
centos-nightly-slim, jdk8u-centos-nightly-slim, ppc64le-centos-jdk8u-nightly-slim, x86_64-centos-jdk8u-nightly-slim, (8/jdk/centos/Dockerfile.openj9.nightly.slim )
centos-jre-nightly, jre8u-centos-nightly, ppc64le-centos-jre8u-nightly, x86_64-centos-jre8u-nightly, (8/jre/centos/Dockerfile.openj9.nightly.full )
clefos-nightly, jdk8u-clefos-nightly, s390x-clefos-jdk8u-nightly, (8/jdk/clefos/Dockerfile.openj9.nightly.full )
clefos-nightly-slim, jdk8u-clefos-nightly-slim, s390x-clefos-jdk8u-nightly-slim, (8/jdk/clefos/Dockerfile.openj9.nightly.slim )
clefos-jre-nightly, jre8u-clefos-nightly, s390x-clefos-jre8u-nightly, (8/jre/clefos/Dockerfile.openj9.nightly.full )
debian-nightly, jdk8u-debian-nightly, ppc64le-debian-jdk8u-nightly, s390x-debian-jdk8u-nightly, x86_64-debian-jdk8u-nightly, (8/jdk/debian/Dockerfile.openj9.nightly.full )
debian-nightly-slim, jdk8u-debian-nightly-slim, ppc64le-debian-jdk8u-nightly-slim, s390x-debian-jdk8u-nightly-slim, x86_64-debian-jdk8u-nightly-slim, (8/jdk/debian/Dockerfile.openj9.nightly.slim )
debian-jre-nightly, jre8u-debian-nightly, ppc64le-debian-jre8u-nightly, s390x-debian-jre8u-nightly, x86_64-debian-jre8u-nightly, (8/jre/debian/Dockerfile.openj9.nightly.full )
debianslim-nightly, jdk8u-debianslim-nightly, ppc64le-debianslim-jdk8u-nightly, s390x-debianslim-jdk8u-nightly, x86_64-debianslim-jdk8u-nightly, (8/jdk/debianslim/Dockerfile.openj9.nightly.full )
debianslim-nightly-slim, jdk8u-debianslim-nightly-slim, ppc64le-debianslim-jdk8u-nightly-slim, s390x-debianslim-jdk8u-nightly-slim, x86_64-debianslim-jdk8u-nightly-slim, (8/jdk/debianslim/Dockerfile.openj9.nightly.slim )
debianslim-jre-nightly, jre8u-debianslim-nightly, ppc64le-debianslim-jre8u-nightly, s390x-debianslim-jre8u-nightly, x86_64-debianslim-jre8u-nightly, (8/jre/debianslim/Dockerfile.openj9.nightly.full )
leap-nightly, jdk8u-leap-nightly, ppc64le-leap-jdk8u-nightly, x86_64-leap-jdk8u-nightly, (8/jdk/leap/Dockerfile.openj9.nightly.full )
leap-jre-nightly, jre8u-leap-nightly, ppc64le-leap-jre8u-nightly, x86_64-leap-jre8u-nightly, (8/jre/leap/Dockerfile.openj9.nightly.full )
tumbleweed-nightly, jdk8u-tumbleweed-nightly, ppc64le-tumbleweed-jdk8u-nightly, s390x-tumbleweed-jdk8u-nightly, x86_64-tumbleweed-jdk8u-nightly, (8/jdk/tumbleweed/Dockerfile.openj9.nightly.full )
tumbleweed-jre-nightly, jre8u-tumbleweed-nightly, ppc64le-tumbleweed-jre8u-nightly, s390x-tumbleweed-jre8u-nightly, x86_64-tumbleweed-jre8u-nightly, (8/jre/tumbleweed/Dockerfile.openj9.nightly.full )
ubi-nightly, jdk8u-ubi-nightly, ppc64le-ubi-jdk8u-nightly, s390x-ubi-jdk8u-nightly, x86_64-ubi-jdk8u-nightly, (8/jdk/ubi/Dockerfile.openj9.nightly.full )
ubi-nightly-slim, jdk8u-ubi-nightly-slim, ppc64le-ubi-jdk8u-nightly-slim, s390x-ubi-jdk8u-nightly-slim, x86_64-ubi-jdk8u-nightly-slim, (8/jdk/ubi/Dockerfile.openj9.nightly.slim )
ubi-jre-nightly, jre8u-ubi-nightly, ppc64le-ubi-jre8u-nightly, s390x-ubi-jre8u-nightly, x86_64-ubi-jre8u-nightly, (8/jre/ubi/Dockerfile.openj9.nightly.full )
ubi-minimal-nightly, jdk8u-ubi-minimal-nightly, ppc64le-ubi-minimal-jdk8u-nightly, s390x-ubi-minimal-jdk8u-nightly, x86_64-ubi-minimal-jdk8u-nightly, (8/jdk/ubi-minimal/Dockerfile.openj9.nightly.full )
ubi-minimal-jre-nightly, jre8u-ubi-minimal-nightly, ppc64le-ubi-minimal-jre8u-nightly, s390x-ubi-minimal-jre8u-nightly, x86_64-ubi-minimal-jre8u-nightly, (8/jre/ubi-minimal/Dockerfile.openj9.nightly.full )
nightly, jdk8u-nightly, jdk8u-ubuntu-nightly, ppc64le-ubuntu-jdk8u-nightly, s390x-ubuntu-jdk8u-nightly, x86_64-ubuntu-jdk8u-nightly, (8/jdk/ubuntu/Dockerfile.openj9.nightly.full )
nightly-slim, jdk8u-nightly-slim, jdk8u-ubuntu-nightly-slim, ppc64le-ubuntu-jdk8u-nightly-slim, s390x-ubuntu-jdk8u-nightly-slim, x86_64-ubuntu-jdk8u-nightly-slim, (8/jdk/ubuntu/Dockerfile.openj9.nightly.slim )
jre-nightly, jre8u-nightly, jre8u-ubuntu-nightly, ppc64le-ubuntu-jre8u-nightly, s390x-ubuntu-jre8u-nightly, x86_64-ubuntu-jre8u-nightly, (8/jre/ubuntu/Dockerfile.openj9.nightly.full )
Quick reference
Overview
The images in this repository contain OpenJDK binaries that are built with Eclipse OpenJ9 .
Eclipse 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 binaries that include Eclipse OpenJ9 are available through AdoptOpenJDK .
Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates.
Multi-arch image
OpenJ9 has multi-arch support so the same commands work on all supported architectures.
How to use this Image
To run a pre-built jar file with the latest Java 8 OpenJDK image, use the following commands:
FROM adoptopenjdk/openjdk8-openj9:ubi
RUN mkdir /opt/app
COPY japp.jar /opt/app
CMD ["java", "-jar", "/opt/app/japp.jar"]
Copy
You can build and run the Docker image as shown in the following example:
$ docker build -t japp .
$ docker run -it --rm japp
Copy
To get a specific version of a docker image, add the build number as shown in the following example:
$ docker run --rm -it adoptopenjdk/openjdk8-openj9:jre8u282-b08_openj9-0.24.0 java -version
openjdk version "1.8.0_282"
OpenJDK Runtime Environment (build 1.8.0_282-b08)
Eclipse OpenJ9 VM (build openj9-0.24.0, JRE 1.8.0 Linux amd64-64-Bit Compressed References 20210120_930 (JIT enabled, AOT enabled)
OpenJ9 - 345e1b09e
OMR - 741e94ea8
JCL - ab07c6a8fd based on jdk8u282-b08)
Copy
Using the Class Data Sharing feature
Eclipse OpenJ9 provides a feature called Class data sharing . This mechanism offers transparent and dynamic sharing of data between multiple Java virtual machines (JVMs) running on the same host, which reduces the amount of physical memory consumed by each JVM instance. By providing partially verified classes and possibly pre-loaded classes in memory, this mechanism also improves the start up time of the JVM.
To enable class data sharing between JVMs that are running in different containers on the same host, a common location must be shared between containers. This requirement can be satisfied through the host or a data volume container. When enabled, class data sharing creates a named "class cache", which is a memory-mapped file, at the common location. This feature is enabled by passing the -Xshareclasses option to the JVM as shown in the following Dockerfile example:
FROM adoptopenjdk/openjdk8-openj9:latest
RUN mkdir /opt/shareclasses
RUN mkdir /opt/app
COPY japp.jar /opt/app
CMD ["java", "-Xshareclasses:cacheDir=/opt/shareclasses", "-jar", "/opt/app/japp.jar"]
Copy
The cacheDir sub-option specifies the location of the class cache. For example /opt/sharedclasses. When sharing through the host, a host path must be mounted onto the container at the location the JVM expects to find the class cache. For example:
docker build -t japp .
docker run -it -v /path/on/host/shareclasses/dir:/opt/shareclasses japp
Copy
When sharing through a data volume container, create a named data volume container that shares a volume. For example:
docker create -v /opt/shareclasses --name classcache japp /bin/true
Copy
Then, start your JVM container by using the --volumes-from flag to mount the shared volume, as shown in the following example:
docker run -it --volumes-from classcache japp
Copy
License
The Dockerfiles and associated scripts are licensed under the Apache License, Version 2.0 .
Licenses for the products installed within the images:
As with all Docker images, other software is likely to be included, which might 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).
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.