IDM

Java requirements

In IDM 7.4.2 and later, the embedded Jetty web server supports Jetty 12. Future releases of IDM 7.4.x are only compatible with Java 17. Jetty 12 requires this change.

When serving SSL requests, Jetty 12 checks that the incoming host header matches the server certificate’s subject and returns a 400 Bad Request error on a mismatch. If you’re upgrading to IDM 7.4.2 or later, you must ensure your IDM server certificate subject matches the host name used by your deployment.

Learn more in What’s new.

Before you start, follow these steps to ensure that your Java environment is suitable:

  1. Verify that your computer has a supported Java version installed:

    Supported Java Versions
    Vendor Versions

    OpenJDK, including OpenJDK-based distributions:

    • AdoptOpenJDK/Eclipse Temurin

    • Amazon Corretto

    • Azul Zulu

    • Red Hat OpenJDK

    ForgeRock tests most extensively with AdoptOpenJDK/Eclipse Temurin. ForgeRock recommends using the HotSpot JVM.

    17**

    Oracle Java

    17**

    ** Version 17.0.9 or higher.

  2. Read the pre-installation requirements.

  3. Set the JAVA_HOME environment variable:

    Set JAVA_HOME on Windows

    1. Locate the JRE installation directory (typically, C:\Program Files\Java\).

    2. Click Start > Control Panel > System and Security > System.

    3. Click Advanced System Settings.

    4. Click Environment Variables.

    5. Under System Variables, click New.

    6. Enter the Variable name (JAVA_HOME) and set the Variable value to the JRE installation directory; for example C:\Program Files\Java\jre8.

    7. Click OK.

    Set JAVA_HOME on Linux

    1. Open the user shell configuration file found in your home directory.

    2. Add the JAVA_HOME variable to the user shell configuration file, setting the value to /usr. In Bash, this would appear as export JAVA_HOME="/usr".