What causes UserErrorJreNotFound?

No JRE is installed on the self-hosted integration runtime machine. The JAVA_HOME environment variable is not set or points to a wrong path. A 32-bit JRE is installed but the IR requires 64-bit Java

How do I fix UserErrorJreNotFound?

Install a compatible 64-bit Java Runtime Environment (JRE 8 or later) on the self-hosted IR machine.. Ensure the JAVA_HOME environment variable points to the JRE installation directory.. Restart the self-hosted IR service after installing Java.. Verify the JRE bitness matches the IR bitness (both must be 64-bit).

Medium severityinfrastructure

Power BI Refresh Error:
UserErrorJreNotFound

What does this error mean?

The self-hosted integration runtime cannot find a Java Runtime Environment (JRE). JDBC-based connectors such as SAP, Oracle, and Hive require Java on the IR host.

Common causes

1No JRE is installed on the self-hosted integration runtime machine
2The JAVA_HOME environment variable is not set or points to a wrong path
3A 32-bit JRE is installed but the IR requires 64-bit Java

How to fix it

1Install a compatible 64-bit Java Runtime Environment (JRE 8 or later) on the self-hosted IR machine.
2Ensure the JAVA_HOME environment variable points to the JRE installation directory.
3Restart the self-hosted IR service after installing Java.
4Verify the JRE bitness matches the IR bitness (both must be 64-bit).

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/copy-activity-fault-tolerance