What causes FailedToDownloadCustomPlugins?

Failed to download custom plugins. 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 FailedToDownloadCustomPlugins?

Verify the SHIR host machine has outbound HTTPS access to Azure storage endpoints (*.blob.core.windows.net, *.azuredatalakestore.net) — corporate firewalls block these for plugin downloads.. If a proxy server is configured on the SHIR host, verify it allows connections to Azure storage endpoints — the SHIR uses system proxy settings for plugin downloads.. Check the Microsoft Integration Runtime service log on the SHIR host (Event Viewer > Applications and Services > Microsoft Integration Runtime) for the specific download URL and error.. Upgrade the SHIR to the latest version — some plugin download failures occur because an outdated IR version references deprecated download endpoints.. For air-gapped environments, work with your network team to whitelist the specific Azure Storage URLs required for IR plugin downloads.

Medium severityinfrastructure

Power BI Refresh Error:
FailedToDownloadCustomPlugins

What does this error mean?

ADF could not download one or more custom plugins required by the self-hosted integration runtime. Check network access to the plugin download URL and verify the IR has internet connectivity.

Common causes

1Failed to download custom plugins
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

1Verify the SHIR host machine has outbound HTTPS access to Azure storage endpoints (*.blob.core.windows.net, *.azuredatalakestore.net) — corporate firewalls block these for plugin downloads.
2If a proxy server is configured on the SHIR host, verify it allows connections to Azure storage endpoints — the SHIR uses system proxy settings for plugin downloads.
3Check the Microsoft Integration Runtime service log on the SHIR host (Event Viewer > Applications and Services > Microsoft Integration Runtime) for the specific download URL and error.
4Upgrade the SHIR to the latest version — some plugin download failures occur because an outdated IR version references deprecated download endpoints.
5For air-gapped environments, work with your network team to whitelist the specific Azure Storage URLs required for IR plugin downloads.

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