The documentation on how to set up the integration lacks fundamental information.
It took me an hour to figure out that you have to enter the IP address in the host field – there is no DNS resolution done if you enter a valid hostname.
If your Pi-Hole is secured by SSL (mine is behind an NGINX proxy doing the SSL stuff - plain http:// requests get rejected) you have to make sure that you
- uncheck the
Verify SSL certificate
box in the config_flow since the entered IP address can’t pass a check against the certificate’s hostname and - configure a catch all clause within your proxy (I had to add a –until now never needed– 308 permanent rewrite pointing to the Pi-Hole’s https address).
After setting up the integration (Pi-Hole’s API key you find in its settings
→ API / Web interface
behind the Show API token
button) you’ll be unable to visit your Pi-Hole from HA’s device page if your proxy is configured to deflect IP adresses (host names only).
This integration (and its documentation) could really use a little more from the devs…