What causes HybridDeliveryException?

Java Runtime Environment (JRE) is not installed on the Self-Hosted IR host machine. JRE is installed but the bitness does not match the IR installation (e.g., 32-bit JRE with 64-bit IR). The JAVA_HOME environment variable is not set or points to an incorrect JRE path after installation. JRE was installed after the IR service started and the service has not been restarted to pick up the new environment variable

How do I fix HybridDeliveryException?

Step 1: Determine the bitness of your Self-Hosted IR installation (64-bit is standard); download the matching 64-bit JRE from https://www.java.com or the link in the error message (http://go.microsoft.com/fwlink/?LinkId=808605).. Step 2: Install the JRE on the Self-Hosted IR host machine and confirm the installation completes without errors.. Step 3: Set the JAVA_HOME system environment variable to the JRE installation path (e.g., C:\Program Files\Java\jre1.8.0_XXX) and add %JAVA_HOME%\bin to the system PATH variable.. Step 4: Restart the Self-Hosted Integration Runtime service via the IR Configuration Manager or Windows Services so the process inherits the updated environment variables.. Step 5: Re-run the Copy activity with ORC or Parquet format and verify that the HybridDeliveryException no longer appears.

High severityconfigurationAzure Data Factory →

Power BI Refresh Error:
HybridDeliveryException

What does this error mean?

The Self-Hosted IR could not locate a Java Runtime Environment (JRE) required to process Java-dependent file formats such as ORC or Parquet, resulting in a HybridDeliveryException with the UserErrorJreNotFound error code.

Common causes

1Java Runtime Environment (JRE) is not installed on the Self-Hosted IR host machine
2JRE is installed but the bitness does not match the IR installation (e.g., 32-bit JRE with 64-bit IR)
3The JAVA_HOME environment variable is not set or points to an incorrect JRE path after installation
4JRE was installed after the IR service started and the service has not been restarted to pick up the new environment variable

How to fix it

1Step 1: Determine the bitness of your Self-Hosted IR installation (64-bit is standard); download the matching 64-bit JRE from https://www.java.com or the link in the error message (http://go.microsoft.com/fwlink/?LinkId=808605).
2Step 2: Install the JRE on the Self-Hosted IR host machine and confirm the installation completes without errors.
3Step 3: Set the JAVA_HOME system environment variable to the JRE installation path (e.g., C:\Program Files\Java\jre1.8.0_XXX) and add %JAVA_HOME%\bin to the system PATH variable.
4Step 4: Restart the Self-Hosted Integration Runtime service via the IR Configuration Manager or Windows Services so the process inherits the updated environment variables.
5Step 5: Re-run the Copy activity with ORC or Parquet format and verify that the HybridDeliveryException no longer appears.

Frequently asked questions

Do I need JRE for all ADF Copy activities or only specific formats?

JRE is only required when copying files in Java-dependent formats such as ORC and Parquet on a Self-Hosted IR. Copy activities using CSV, JSON, Avro, or binary formats do not require JRE.

Will upgrading to a newer JRE version break anything in the IR?

ADF Self-Hosted IR supports standard JRE 8+ releases. Using a current LTS release (e.g., JRE 11 or 17) is generally safe, but always match the bitness (64-bit IR requires 64-bit JRE) and restart the IR service after any JRE upgrade.