Pi-hole Version 6 Update

Recently, I have been planning to make some changes to my network topology. As I was checking the configuration of all devices remotely, I decided this was a good opportunity to apply updates and generally tidy up old configuration.

For Pi-hole, updating is usually painless and only needs a pihole -up to pull in a new version of the software.

I use Home Assistant to monitor my homelab and I noticed that the Pi-hole integration was no longer working. It did not take long to find that there was an API change in version 6 of Pi-hole. There is a new Pi-hole integration that offers compatibility with version 6; via HACS.

The README files are pretty good at explaining what needs to be done, so I won't repeat them here but instead give a quick overview of the process:

1. Add the URL for the new integration repo to HACS in Home Assistant
2. You need Home Assistant version 2025.3 or newer. I run HA as a docker image on my NAS so that meant I needed to make my NAS pull the latest docker image
3. Download the integration in HACS
4. Restart Home Assistant
5. Remove the original Pi-hole integration
6. Add the Pi-holes to HA - you will need your admin password
7. Add the integration to a dashboard

Asides from the docker stuff, the whole process took less than 30 minutes.

< Back