Packaging OpenJDK 8 applications in containers

OpenJDK 8

Red Hat Developer Customer Content Services


OpenJDK is a Red Hat offering on the Red Hat Enterprise Linux platform. The Packaging OpenJDK 8 applications in containers guide provides an overview of this product and explains how to package the applications in a container.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. We are beginning with these four terms: master, slave, blacklist, and whitelist. Because of the enormity of this endeavor, these changes will be implemented gradually over several upcoming releases. For more details, see our CTO Chris Wright’s message.

Providing feedback on Red Hat documentation

We appreciate your feedback on our documentation. To provide feedback, you can highlight the text in a document and add comments.

This section explains how to submit feedback.


  • You are logged in to the Red Hat Customer Portal.
  • In the Red Hat Customer Portal, view the document in Multi-page HTML format.


To provide your feedback, perform the following steps:

  1. Click the Feedback button in the top-right corner of the document to see existing feedback.


    The feedback feature is enabled only in the Multi-page HTML format.

  2. Highlight the section of the document where you want to provide feedback.
  3. Click the Add Feedback pop-up that appears near the highlighted text.

    A text box appears in the feedback section on the right side of the page.

  4. Enter your feedback in the text box and click Submit.

    A documentation issue is created.

  5. To view the issue, click the issue tracker link in the feedback view.

Chapter 1. OpenJDK applications in containers

OpenJDK images have default startup scripts that automatically detect application JAR files and launch Java. The script’s behavior can be customized using environment variables. For more information, see / in the container.

The OpenJDK applications in the /deployments directory of the OpenJDK image are run when the image loads.


Containers that contain OpenJDK applications are not automatically updated with security updates. Ensure that you update these images at least once every three months.

Application JAR files can be fat JARs or thin JARs.

  • Fat JARs contain all of the application’s dependencies.
  • Thin JARs reference other JARs that contain some, or all, of the application’s dependencies.

    Thin JARs are only supported if:

    • They have a flat classpath.
    • All dependencies are JARs that are in the /deployments directory.

Chapter 2. Deploying OpenJDK applications in containers

You can deploy OpenJDK applications in containers and have them run when the container is loaded.


  • Copy the application JAR to the /deployments directory in the image JAR file.

    For example, the following shows a brief Dockerfile that adds an application called testubi.jar to the OpenJDK 8 UBI8 image:

    COPY target/testubi.jar /deployments/testubi.jar

Chapter 3. Updating OpenJDK container images

To ensure that an OpenJDK container with Java applications includes the latest security updates, rebuild the container.


  1. Pull the base OpenJDK image.
  2. Deploy the OpenJDK application. For more information, see Deploying OpenJDK applications in containers.

    The OpenJDK container with the OpenJDK application is updated.

Additional resources

Legal Notice

Copyright © 2021 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.