The Pi-hole integration allows you to retrieve statistics and interact with a Pi-hole system. If your Pi-hole web interface is password protected, an API key is needed for the setup (from Settings -> API / Web interface).


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


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

Example service call:

# Example service call to disable Pi-Hole for 30 minutes
service: pi_hole.disable
  duration: '00:30'
  entity_id: all