What causes UserErrorSelfHostedIntegrationRuntimeNotRunning?

The SHIR Windows service (Microsoft Integration Runtime) is stopped on the host machine. The host machine is powered off, rebooted, or in maintenance. A SHIR auto-update in progress temporarily took the node offline. The SHIR node lost connectivity to the Azure Service Bus relay endpoint. The SHIR registration key expired and the node needs to be re-registered

How do I fix UserErrorSelfHostedIntegrationRuntimeNotRunning?

Log in to the SHIR host and verify 'Microsoft Integration Runtime' is running in Services.msc.. If the service is stopped, start it and wait 2–3 minutes for the node to reconnect to ADF.. Check SHIR status in ADF Studio under Manage > Integration Runtimes — it should show 'Running'.. Verify the host machine can reach *.servicebus.windows.net on port 443.. If all else fails, re-register the SHIR using the authentication key from the ADF portal.

High severitygateway

Power BI Refresh Error:
UserErrorSelfHostedIntegrationRuntimeNotRunning

What does this error mean?

The self-hosted integration runtime (SHIR) referenced by the ADF pipeline is offline. ADF cannot dispatch activities to the runtime.

Common causes

1The SHIR Windows service (Microsoft Integration Runtime) is stopped on the host machine
2The host machine is powered off, rebooted, or in maintenance
3A SHIR auto-update in progress temporarily took the node offline
4The SHIR node lost connectivity to the Azure Service Bus relay endpoint
5The SHIR registration key expired and the node needs to be re-registered

How to fix it

1Log in to the SHIR host and verify 'Microsoft Integration Runtime' is running in Services.msc.
2If the service is stopped, start it and wait 2–3 minutes for the node to reconnect to ADF.
3Check SHIR status in ADF Studio under Manage > Integration Runtimes — it should show 'Running'.
4Verify the host machine can reach *.servicebus.windows.net on port 443.
5If all else fails, re-register the SHIR using the authentication key from the ADF portal.

Frequently asked questions

Does a self-hosted integration runtime failure affect all pipelines using it?

Yes — all pipelines routed through the affected SHIR fail simultaneously.

How do I check the health of a self-hosted integration runtime?

Open Microsoft Integration Runtime Configuration Manager on the SHIR host. The Status tab shows connection state and version. ADF Studio also shows SHIR health under Manage > Integration Runtimes.

What ports does a self-hosted integration runtime need outbound access to?

Outbound HTTPS (port 443) to *.servicebus.windows.net and *.core.windows.net. Individual connectors may need additional ports — SQL Server: 1433, FTP: 21.

Can I have multiple nodes in a self-hosted integration runtime for redundancy?

Yes — up to four nodes per SHIR. If one goes offline, ADF routes to a healthy node. Use at least two nodes for production pipelines.

Official documentation: https://learn.microsoft.com/en-us/azure/data-factory/self-hosted-integration-runtime-troubleshoot-guide