Oracle GraalVM Container Images
Oracle GraalVM container images are available in Oracle Container Registry (OCR) under the GraalVM Free Terms and Conditions (GFTC) license.
Repositories
Oracle GraalVM container images are published in two OCR repositories: jdk and native-image.
Repository | Description |
---|---|
jdk | Provides container images with Oracle GraalVM JDK (without the native-image utility) which can be used to both compile and deploy a Java application. Use the container image tags to select the appropriate Java version and Oracle Linux version. |
native-image | Provides Oracle GraalVM container images with the native-image utility along with all tools required to compile an application into a native Linux executables. These images are commonly used in multistage builds to compile an application into an executable that is then packaged in a lightweight container image. Use the container image tags to select the Java version and Oracle Linux version as well as variants that include the musl toolchain for the creation of a fully statically linked executable. |
Both repositories provide container images for x64 and AArch64 processor architectures, with a choice of Oracle Linux versions 7, 8, or 9.
Oracle GraalVM is installed in /usr/lib64/graalvm/graalvm-java<$FeatureVersion>/ where <$FeatureVersion>
is 17
, 21
, 23
, and so on.
For example, Oracle GraalVM for JDK 23 is installed in /usr/lib64/graalvm/graalvm-java23/.
All binaries, including java
, javac
, native-image
, and other binaries are available as global commands via the alternatives
command.
Tags
Each repository provides multiple tags that let you choose the level of stability you need including the Java version, build number, and the Oracle Linux version. Oracle GraalVM container image tags use the following naming convention:
$version[-muslib(for native image only)][-$platform][-$buildnumber]
The following tags are listed from the most-specific tag (at the top) to the least-specific tag (at the bottom). The most-specific tag is unique and always points to the same container image, while the less-specific tags point to newer container image variants over time.
22.0.1-ol9-20240504
22.0.1-ol9
22.0.1
22-ol9
22
Pulling Images
- To pull the container image for Oracle GraalVM JDK for a specific JDK feature version, such as 23, run:
docker pull container-registry.oracle.com/graalvm/jdk:23
Alternatively, to use the container image as the base image in your Dockerfile, use:
FROM container-registry.oracle.com/graalvm/jdk:23
- To pull the container image for Oracle GraalVM
native-image
utility for a specific JDK feature version, such as 23, run:docker pull container-registry.oracle.com/graalvm/native-image:23
Alternatively, to pull the container image for Oracle GraalVM
native-image
utility with themusl libc
toolchain to create fully statically linked executables, run:docker pull container-registry.oracle.com/graalvm/native-image:23-muslib
Alternatively, to use the container image as the base image in your Dockerfile, use:
FROM container-registry.oracle.com/graalvm/native-image:23-muslib
- To verify, start the container and enter a Bash session:
docker run -it --rm --entrypoint /bin/bash container-registry.oracle.com/graalvm/native-image:23
To check the version of Oracle GraalVM and its installed location, run the
env
command from thebash
prompt:env
The output includes the environment variable
JAVA_HOME
with its value corresponding to the installed GraalVM version and location.To check the version of GraalVM and its installed location, run the
env
command from the Bash prompt:java -version
The output shows the installed Oracle GraalVM Java runtime environment and version information.
To check the
native-image
version, run the following command from the Bash prompt:native-image --version
The output shows the installed Oracle GraalVM
native-image
utility version information. - A
docker pull
command that omits a processor architecture pulls a container image for the processor architecture that matches your Docker client. To pull a container image for a different platform architecture, specify the desired platform architecture with the--platform
option and eitherlinux/amd64
orlinux/aarch64
as follows:docker pull --platform linux/aarch64 container-registry.oracle.com/graalvm/native-image:23
Related Documentation
- Tiny Java Containers: Learn how GraalVM Native Image can generate native executables ideal for containerization.
- Announcement Blog: New Oracle GraalVM Container Images