home-assistant.io/source/_integrations/pi_hole.markdown

title, description, ha_category, ha_iot_class, ha_config_flow, ha_release, ha_codeowners, ha_domain, ha_platforms, ha_integration_type

title	description	ha_category	ha_iot_class	ha_config_flow	ha_release	ha_codeowners	ha_domain	ha_platforms	ha_integration_type
Pi-hole	Instructions on how to integrate Pi-hole with Home Assistant.	Sensor Switch System Monitor Update	Local Polling	true	0.28	@johnluetke @shenxn	pi_hole	binary_sensor sensor switch update	integration

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).

{% include integrations/config_flow.md %}

Services

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
data:
  duration: '00:30'
target:
  entity_id: all