Skip to main content Skip to complementary content

Specifying a Java version to run Jobs or Microservices

Enable your Remote Engine to run Jobs or Microservices using a specific Java version.

By default, a Remote Engine uses the Java version of its environment to execute Jobs or Microservices. With Remote Engine v2.13 and onwards, Java 17 is mandatory for engine startup. However, when it comes to running Jobs or Microservices, you can specify a different Java version. This feature allows you to use a newer engine version to run the artifacts designed with older Java versions, without the need to rebuild these artifacts, such as some Big Data Jobs that rely on Java 8 only.

When developing new Jobs or Microservices, consider building them with the add-opens option to ensure compatibility with Java 17. This option opens the necessary packages for Java 17 compatibility, making your Jobs or Microservices directly runnable on the newer Remote Engine version, without having to go through the procedure explained in this section for defining a specific Java version. For further information about how to use this add-opens option and its limitation, see Setting up Java in Talend Studio.

Information noteTip: Specifying a Java version during installation using the installer is an alternative to this section, but the version defined here takes precedence for Job and Microservice executions.


  1. Stop the engine.
  2. Browse to the <RemoteEngineInstallationDirectory>/etc directory.
  3. Depending on the type of the artifacts you need to run with a specific Java version, do the following:
    • For Jobs, add the path to your Java instance to be used to your PATH environment variable. Then open a command-line terminal and execute the java -version command. You should see the version of the Java instance printed.

      Any Java process starts with this instance defined in the PATH.

    • For Microservices, in the <RemoteEngineInstallationDirectory>/etc/org.talend.ipaas.rt.dsrunner.cfg, add the path to the Java executable file. For example,

      Make this modification before deploying your Microservices to ensure that these changes are correctly taken into account.

    For both artifact types, use backslashes to escape characters specific to a Windows path, such as colons, whitespace, and directory separators, while keeping in mind that directory separators are also backslashes on Windows. For example:
    c:\\Program\ Files\\Java\\jdk11.0.18_10\\bin\\java.exe
  4. Restart the engine.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!