ubuntu/jre repository overview

⁠Chiselled Ubuntu for jre

Current jre Docker Image from Canonical⁠, based on Ubuntu. Receives security updates and rolls to newer jre or Ubuntu release. This repository is free to use and exempt from per-user rate limits.

⁠About jre

This image packs the Java Runtime Environment, coming from the OpenJDK project⁠, a free and open source implementation of the Java Platform, Standard Edition (Java SE). OpenJDK is the official reference implementation of Java SE since version 7. Read more⁠. Java is a registered trademark of Oracle and/or its affiliates.

⁠About Chiselled Ubuntu

This image does not include bash nor a package manager nor the OpenJDK. Its purpose is to serve as a runtime, final-stage base image for compatible Java applications.

Read more about chiselled Ubuntu for OpenJDK JRE, a new class of OCI images, on the Ubuntu blog⁠. And remember, the best base image is FROM scratch: so you could also easily craft your own chiselled Ubuntu base⁠ for your app specific needs.

Please note that the Ubuntu 22.04 JRE images are Dockerfile-base images, whereas from Ubuntu 24.04 onward the images are now rocks. As such the entrypoint is now Pebble. Read more on the Rockcraft docs⁠.

Ubuntu 22.04 JRE images have java as the entrypoint.

$ docker run --rm ubuntu/jre:17_edge
Usage: java [options] <mainclass> [args...]

Ubuntu 24.04 JRE images have pebble enter as the entrypoint. You can access the java with the following command:

$ docker run --rm ubuntu/jre:21_edge exec java
Usage: java [options] <mainclass> [args...]
...

⁠Tags and Architectures

Up to 5 years of free security maintenance on LTS channels.

Up to 10 years of customer security maintenance from Canonical's restricted repositories⁠.

Channel Tags shows the most stable channel for that track ordered stable, candidate, beta, edge. More risky channels are always implicitly available. So if beta is listed, you can also pull edge. If candidate is listed, you can pull beta and edge. When stable is listed, all four are available. Images are guaranteed to progress through the sequence edge, beta, candidate before stable.

⁠Commercial use and Extended Security Maintenance channels

If your usage includes commercial redistribution, or requires ESM or unavailable channels/versions, please get in touch with the Canonical team⁠ (or using [email protected]⁠).

⁠Usage

Launch this image locally:

docker run -d --name jre-container -e TZ=UTC --rm ubuntu/jre:11-24.04_stable

For Ubuntu 24.04 JRE

docker run --rm --name jre-container -e TZ=UTC ubuntu/jre:21-24.04_edge exec java

The container logs will simply show the OpenJRE help message. This is because the container expects a compiled Java application to be given.

Let's use the following Hello World application as an example:

// HelloWorld.java

class HelloWorld
{
    public static void main(String args[])
    {
        System.out.println("Hello, World");
    }
}

You can build and package the above Hello World application with chiselled Ubuntu 22.04 JRE 8 and 17 using the following example Dockerfile.

FROM ubuntu:22.04 AS builder
RUN apt-get update && apt-get install -y openjdk-8-jdk
WORKDIR /app
ADD HelloWorld.java .

RUN javac -source 8 -target 8 HelloWorld.java -d .

FROM ubuntu/jre:8-22.04_edge

WORKDIR /
COPY --from=builder /app/HelloWorld.class .

CMD [ "HelloWorld" ]

For Ubuntu 24.04 please use

FROM ubuntu:24.04 AS builder
RUN apt-get update && apt-get install -y openjdk-8-jdk
WORKDIR /app
ADD HelloWorld.java .

RUN javac -source 8 -target 8 HelloWorld.java -d .

FROM ubuntu/jre:21-24.04_edge

COPY --from=builder /app/HelloWorld.class .

CMD [ "exec", "java", "-cp", "/", "HelloWorld" ]

⁠Testing/Debugging

To debug the container:

docker logs -f jre-container

⁠Debugging

To debug the container:

docker logs -f openjdk-jre-container

For Ubuntu 24.04 JRE, to inspect application logs:

docker exec openjdk-jre-container pebble logs

⁠Bugs and feature requests

If you find a bug in our image or want to request a specific feature, please file a bug here:

https://bugs.launchpad.net/ubuntu-docker-images/+filebug⁠

Please title the bug "jre: <issue summary>". Make sure to include the digest of the image you are using, from:

docker images --no-trunc --quiet ubuntu/jre:<tag>

⁠Deprecated channels & tags

These channels (tags) are not updated anymore. Please upgrade to newer channels, or reach out⁠ if you can't upgrade.