pi_hole integration allows you to retrieve statistics and interact with a Pi-hole system.
To enable this integration, go to the Integrations page inside the configuration panel. You can also use YAML configuration. Add the following lines to your
# Example configuration.yaml entry pi_hole: - host: IP_ADDRESS
The hostname (and port), e.g., ‘192.168.0.3:4865’ of the host where Pi-hole is running. Home Assistant add-on users should be sure to specify port
The name for this Pi-hole. This name will be a part of the sensors created, e.g.,
name: My Awesome Pi-hole would result in sensor names beginning with
Verify the SSL/TLS certificate of the system. If your Pi-hole instance uses a self-signed certificate, you should specify
Single Pi-hole running via Home Assistant add-on:
pi_hole: - host: 'localhost:4865'
pi_hole: - host: '192.168.0.2' - host: '192.168.0.3' name: 'Secondary Pi-hole'
Pi-hole with a self-signed certificate:
pi_hole: - host: 'pi.hole' ssl: true verify_ssl: false
Pi-hole with an
api_key that allows it to be enabled or disabled:
pi_hole: - host: 'pi.hole' api_key: !secret pi_hole_api_key
The platform provides the following services to interact with your Pi-hole. Use switch entities when calling the services.
Note: Switch entity requires
api_key to be configured.
Disables configured Pi-hole(s) for the specified amount of time.
|Service data attribute||Required||Type||Description|
||string||Target switch entity. Use
||timedelta||Time for which Pi-hole should be disabled|