The Pi-hole integration allows you to retrieve statistics and interact with a Pi-hole system.


Adding Pi-hole to your Home Assistant instance can be done via the user interface, by using this My button:

Manual configuration steps

Please note, that during the integration set up, an API key can be provided. Providing one, gives access to the Pi-Hole disable service and a switch to enable/disable Pi-Hole from Home Assistant.


The platform provides the following services to interact with your Pi-hole. Use switch entities when calling the services.

Service pi_hole.disable

Disables configured Pi-hole(s) for the specified amount of time.

Service data attribute Required Type Description
entity_id False string Target switch entity. Use all to target all Pi-hole services
duration True timedelta Time for which Pi-hole should be disabled