Manage an on-premises data gateway

Note

We recently revised the on-premises data gateway docs. We split them into content that's specific to Power BI and general content that applies to all services that the gateway supports. You're currently in the general content. To provide feedback on this article, or the overall gateway docs experience, scroll to the bottom of the article.

After you install an on-premises data gateway, you manage it based on your requirements. Because each service might integrate gateways differently, the management options differ depending on the service. Although you can manage gateways from any service, the articles in this section refer to the Manage gateways page in Power BI.

How to select "Manage gateways"

Note

Manage gateways will not show up until you're the admin of at least one gateway. You become an admin either by being added as an admin or because you installed and configured a gateway.

Manage gateway admins

When you install a gateway, you are by default an admin of that gateway. You then add additional users or security groups as admins by using the Administrators tab for the gateway. You also use this tab to remove admins.

Gateway administrators tab

Note

Security groups without email addresses can't be added.

Remove or delete an on-premises data gateway

Depending on the service you're using you can either remove or delete a gateway. In Power BI you remove a gateway, but in PowerApps and Power Automate, you delete a gateway.

But, be aware that removing a gateway in Power BI deletes all the data sources under it. In turn, deleting the Power BI data sources causes errors in Power BI dashboards and reports that rely on those data sources.

Note

If you remove or delete a gateway cluster in any of the cloud services, you won't be able to restore it. Also, when you remove or delete a gateway cluster, the gateway is not uninstalled from the gateway machines. You have to manually uninstall the gateway from each machine in the cluster.

For example, to remove a gateway in the Power BI service:

  1. In the upper-right corner of the Power BI service, select the gear icon Settings gear icon > Manage gateways.

  2. Select the gateway and then select Remove.

    How to remove a gateway

Next steps