What causes JreNotFound?

Java Runtime not found. Integration runtime configuration is incorrect or outdated. Authentication credentials or permissions are insufficient. The feature or setting is not supported for the selected connector or copy mode

How do I fix JreNotFound?

Install the 64-bit Java Runtime Environment (JRE) 8 or later on the SHIR host machine — download from adoptium.net or oracle.com and install the 64-bit version (not 32-bit).. After installation, set the JAVA_HOME environment variable to the JRE installation directory on the host machine (e.g., C:\Program Files\Java\jre-11).. Add the JRE bin directory to the system PATH environment variable so the IR can locate the java executable.. Restart the 'Microsoft Integration Runtime' Windows service on the SHIR host to load the updated environment variables — the JVM is loaded at service startup and changes do not take effect without a restart.. Verify the fix by clicking 'Test connection' on the linked service in ADF Studio after the IR service restarts.

Medium severityinfrastructure

Power BI Refresh Error:
JreNotFound

What does this error mean?

The integration runtime cannot locate a required Java Runtime Environment (JRE). Connectors that rely on JDBC (such as SAP, Hive, or Oracle) require a JRE to be installed on the self-hosted integration runtime host.

Common causes

1Java Runtime not found
2Integration runtime configuration is incorrect or outdated
3Authentication credentials or permissions are insufficient
4The feature or setting is not supported for the selected connector or copy mode

How to fix it

1Install the 64-bit Java Runtime Environment (JRE) 8 or later on the SHIR host machine — download from adoptium.net or oracle.com and install the 64-bit version (not 32-bit).
2After installation, set the JAVA_HOME environment variable to the JRE installation directory on the host machine (e.g., C:\Program Files\Java\jre-11).
3Add the JRE bin directory to the system PATH environment variable so the IR can locate the java executable.
4Restart the 'Microsoft Integration Runtime' Windows service on the SHIR host to load the updated environment variables — the JVM is loaded at service startup and changes do not take effect without a restart.
5Verify the fix by clicking 'Test connection' on the linked service in ADF Studio after the IR service restarts.

Frequently asked questions

Does a JRE or JVM error affect all pipelines or only specific connectors?

JVM errors affect only pipelines processing Parquet, ORC, or Avro on a self-hosted integration runtime. Pipelines using other connectors on the same SHIR are not affected.

Why does ADF require a JRE for some file formats?

Parquet, ORC, and Avro use Java-based codec libraries. On a self-hosted IR, ADF invokes a JVM on the host for codec operations. Azure IR includes the JVM; self-hosted IRs require it to be installed separately.

After installing or updating the JRE, do I need to restart anything?

Yes — restart the Microsoft Integration Runtime service on the SHIR host after any JRE or _JAVA_OPTIONS changes. The JVM loads at IR startup and changes don't take effect until the service restarts.

Can custom plugins on the SHIR cause pipeline failures?

Yes — if FailedToDownloadCustomPlugins appears, the SHIR can't download a required plugin. Verify the host has outbound internet access to the ADF plugin endpoint and that no proxy blocks the download.

Official documentation: https://learn.microsoft.com/en-us/azure/data-factory/connector-troubleshoot-guide