What causes Gateway cluster not found?

The gateway cluster was deleted from Power BI Service by an admin. All gateway machines in the cluster were decommissioned without migrating datasets. The gateway registration was invalidated due to a machine name or domain change. The tenant or workspace admin removed the gateway as part of an infrastructure cleanup

How do I fix Gateway cluster not found?

Go to Power BI Service → Settings → Manage gateways to see available gateway clusters.. If the cluster is missing, a new gateway must be installed and configured on a machine with access to the data source.. After setting up the new gateway, go to each affected dataset → Settings → Gateway connections and map to the new gateway.. Before decommissioning gateways, always migrate dataset mappings first to avoid this situation.. Document which datasets use which gateway clusters to make future migrations easier.

Critical severitygateway

Power BI Refresh Error:
Gateway cluster not found

What does this error mean?

The gateway cluster that was previously associated with this dataset no longer exists or is no longer accessible. This differs from 'no gateway configured' — a gateway WAS configured but it has since been removed.

Common causes

1The gateway cluster was deleted from Power BI Service by an admin
2All gateway machines in the cluster were decommissioned without migrating datasets
3The gateway registration was invalidated due to a machine name or domain change
4The tenant or workspace admin removed the gateway as part of an infrastructure cleanup

How to fix it

1Go to Power BI Service → Settings → Manage gateways to see available gateway clusters.
2If the cluster is missing, a new gateway must be installed and configured on a machine with access to the data source.
3After setting up the new gateway, go to each affected dataset → Settings → Gateway connections and map to the new gateway.
4Before decommissioning gateways, always migrate dataset mappings first to avoid this situation.
5Document which datasets use which gateway clusters to make future migrations easier.

Frequently asked questions

Does this error affect all datasets using the same gateway?

Yes — all datasets routed through the affected gateway will fail simultaneously. Resolving the gateway configuration or credential issue restores all of them at once.

Does this error appear in Power BI Desktop?

No — Power BI Desktop connects directly to data sources. Gateway errors only occur when Power BI Service initiates a scheduled or manual refresh.

Can this error resolve itself without intervention?

No — gateway errors require manual action: re-entering credentials, restarting the gateway service, or correcting the network path between the gateway and the data source.

How long does it typically take to fix?

A simple credential refresh takes 5–10 minutes. Network or firewall issues can take 30–120 minutes depending on your infrastructure access.

Source · learn.microsoft.com/en-us/power-bi/connect-data/service-gateway-onprem-tshoot