Pi-hole integration wont connect to pi-hole v6, after updating to 2025.8.0

[mad-tunes]

The problem

Saw 'Pi-hole users can now leverage API v6 functionality' in the details for core 2025.8.0.
Used to use the integration with V5, so updated Core and gave it another go. Still can't connect to my v6 pi-hole though.

It lets me through setting up the connection but then immediately shows me
Authentication expired for pi-hole and Failed to set up: Authentication failed: Invalid password
Then it wont accept the same pi-hole app/api password or a new one I generate.

I don't see much more info in any pi-hole or HA logs that I can think to check:

Logger: homeassistant.config_entries
Source: config_entries.py:777
First occurred: 22:01:22 (1 occurrence)
Last logged: 22:01:22

Config entry 'Pi-Hole' for pi_hole integration could not authenticate: Authentication failed: Invalid password

I can't think of any other way to use/check the pwd that pi-hole's generated, but I'm as sure I've copied/pasted it properly as I can be.

Is the v6 API the same thing as pi-hole v6 and should this connect to V6 after updating to 2025.8.0?

What version of Home Assistant Core has the issue?

2025.8.0

What was the last working version of Home Assistant Core?

What type of installation are you running?

Home Assistant OS

Integration causing the issue

pi-hole

Link to integration documentation on our website

https://www.home-assistant.io/integrations/pi_hole

Diagnostics information

No response

Example YAML snippet

Anything in the logs that might be useful for us?

Config entry 'Pi-Hole' for pi_hole integration could not authenticate: Authentication failed: Invalid password

Additional information

No response

[home-assistant]

Hey there @shenxn, mind taking a look at this issue as it has been labeled with an integration (pi_hole) you are listed as a code owner for? Thanks!

Code owner commands

Code owners of pi_hole can trigger bot actions by commenting:

• @home-assistant close Closes the issue.
• @home-assistant rename Awesome new title Renames the issue.
• @home-assistant reopen Reopen the issue.
• @home-assistant unassign pi_hole Removes the current integration label and assignees on the issue, add the integration domain after the command.
• @home-assistant add-label needs-more-information Add a label (needs-more-information, problem in dependency, problem in custom component) to the issue.
• @home-assistant remove-label needs-more-information Remove a label (needs-more-information, problem in dependency, problem in custom component) on the issue.

_{^{(message by CodeOwnersMention)}}

---

pi_hole documentation
pi_hole source
_{^{(message by IssueLinks)}}

[JamelD]

Seeing something similar. Below is the error message I see. Tried port 80 and port 443 as I have both open. I have also tried with the location set to "/", "admin", and "api". All of these attempts net the same error.

And here is what my logs say

2025-08-06 21:07:47.633 ERROR (MainThread) [homeassistant.components.pi_hole] Unexpected error connecting to Pi-hole v6 API at http://10.X.X.2:443: Cannot authenticate with Pi-hole: Server disconnected. Trying version 5 API

2025-08-06 21:07:47.636 ERROR (MainThread) [hole.v5] Can not load data from *hole: 10.X.X.2:443

2025-08-06 21:07:47.636 ERROR (MainThread) [homeassistant.components.pi_hole] Failed to connect to Pi-hole v5 API at http://10.X.X.2:443/api/api.php: Can not load data from *hole: 10.X.X.2:443

[sanderdewit]

same issues, also fails to connect.
Also running pihole v6 but without authentication. (via Docker)

2025-08-06 22:43:00.602 ERROR (MainThread) [homeassistant.config_entries] Error setting up entry Pi-Hole for pi_hole
File "/usr/src/homeassistant/homeassistant/components/pi_hole/init.py", line 103, in async_setup_entry
File "/usr/src/homeassistant/homeassistant/components/pi_hole/init.py", line 245, in determine_api_version
2025-08-07 19:41:00.390 ERROR (MainThread) [homeassistant.components.pi_hole] Failed to connect to Pi-hole v5 API at http://x.x.0.x:80/admin//api.php: Can not load data from *hole: x.x.0.x:80

When enabling auth in the pihole v6, it does work. however I prefer to run it without authentication.

[al090187]

I had this, but just got mine to work...... Can someone else try this and see if it works?

On the API setup page I clicked to create an app password. Copy the password, and enter it into the HA setup page for Pi-hole, but don't submit it yet!!

Then on pihole Web interface / API settings submit the app password, and confirm to replace the old one if needed, it then logs you out. Then log back in, go to the API settings page again, and click save & Apply at the bottom. Then when it refreshes, go to the HA page and submit the API password. This worked for me.

For some reason submitting the new app password doesn't seem to actually save it. Seems a problem with PiHole, not this addon.

[sanderdewit]

I had this, but just got mine to work...... Can someone else try this and see if it works?

On the API setup page I clicked to create an app password. Copy the password, and enter it into the HA setup page for Pi-hole, but don't submit it yet!!

Then on pihole Web interface / API settings submit the app password, and confirm to replace the old one if needed, it then logs you out. Then log back in, go to the API settings page again, and click save & Apply at the bottom. Then when it refreshes, go to the HA page and submit the API password. This worked for me.

For some reason submitting the new app password doesn't seem to actually save it. Seems a problem with PiHole, not this addon.

I use Docker and the container config specifies no api password and thus app password does not make a difference. However without authentication it just doesn't work, the code starts with .authenticate() and that fails when it assumes password is required.

As said I solved it be setting up a password, but prefer working without auth for pi-hole.

[mad-tunes]

I had this, but just got mine to work...... Can someone else try this and see if it works?

On the API setup page I clicked to create an app password. Copy the password, and enter it into the HA setup page for Pi-hole, but don't submit it yet!!

Then on pihole Web interface / API settings submit the app password, and confirm to replace the old one if needed, it then logs you out. Then log back in, go to the API settings page again, and click save & Apply at the bottom. Then when it refreshes, go to the HA page and submit the API password. This worked for me.

For some reason submitting the new app password doesn't seem to actually save it. Seems a problem with PiHole, not this addon.

If I do as you describe I still get similar.
The new API pwd lets me through the initial setup page OK, but it immediately shows Failed to set up: Authentication failed: Invalid password.
If I hit Recongfigure and re-enter the same API pwd it shows Invalid authentication

[al090187]

Hmm, I think I got that too, thought I did the password wrong, so regenerated another password, relogin, save, submit etc and that must have got me in. Keep trying, it worked for me in the end, so not sure which is at fault 🤷‍♂️

[danielsza]

same issues, also fails to connect. Also running pihole v6 but without authentication. (via Docker)

2025-08-06 22:43:00.602 ERROR (MainThread) [homeassistant.config_entries] Error setting up entry Pi-Hole for pi_hole File "/usr/src/homeassistant/homeassistant/components/pi_hole/init.py", line 103, in async_setup_entry File "/usr/src/homeassistant/homeassistant/components/pi_hole/init.py", line 245, in determine_api_version 2025-08-07 19:41:00.390 ERROR (MainThread) [homeassistant.components.pi_hole] Failed to connect to Pi-hole v5 API at http://x.x.0.x:80/admin//api.php: Can not load data from *hole: x.x.0.x:80

When enabling auth in the pihole v6, it does work. however I prefer to run it without authentication.

I have the same issue, not running docker.
It from the homebridge image, port is 8080 or 8433
with no password

added a password and it connects.

i was using the HACS version without issue, without a password

[JamelD]

I was able to get it working on my machines.

First, I had to setup an Webserver API password in the advanced settings. FYI, you will have to use this password to login to the Pi-Hole web page. From this point, I would go to the Web Interface/API Settings page to configure the API app password.

The connection only worked for me over port 443 with a SSL cert. It would not work over port 80.

[aleksrozman]

I think this issue is the same as #149769, I noted an annoying workaround which seems to be holding. You just have to get past the first initialization when it determines it is v6.

[Olen]

This might be a different issue, but for my part, I get the error "Could not determine Pi-hole API-version"
Turning on debug, it seems like the authentication here actually succeeds:

core/homeassistant/components/pi_hole/__init__.py

Lines 200 to 201 in 712115c

	try:
	await holeV6.authenticate()

(no, my password is not "wrong_password")

2025-08-08 20:14:28.828 DEBUG (MainThread) [homeassistant.components.pi_hole] Setting up pi_hole integration with host ns2.olen.net:443
2025-08-08 20:14:28.828 DEBUG (MainThread) [homeassistant.components.pi_hole] Determining Pi-hole API version for ns2.olen.net:443
2025-08-08 20:14:28.972 INFO (MainThread) [hole.v6] Successfully authenticated with Pi-hole
2025-08-08 20:14:29.016 DEBUG (MainThread) [hole.v5] Response from *hole: 400
2025-08-08 20:14:29.016 DEBUG (MainThread) [hole.v5] {'error': {'key': 'bad_request', 'message': 'Bad request', 'hint': 'The API is hosted at pi.hole/api, not pi.hole/admin/api'}, 'took': 6.961822509765625e-05}
2025-08-08 20:14:29.016 DEBUG (MainThread) [homeassistant.components.pi_hole] Unexpected response from Pi-hole API at https://ns2.olen.net:443/admin/api.php: {'error': {'key': 'bad_request', 'message': 'Bad request', 'hint': 'The API is hosted at pi.hole/api, not pi.hole/admin/api'}, 'took': 6.961822509765625e-05}
2025-08-08 20:14:29.016 DEBUG (MainThread) [homeassistant.components.pi_hole] Could not determine pi-hole API version at: https://ns2.olen.net:443

Since the holeV6.authenticate() does NOT raise an exception, the whole check for V6 fails, and since it does not return an empty list as expected by V5, that check also fails and that again leads to falure to set up the integration.

There should really be another check there, to see if the authenticte succeeds (and possibly look for the string "The API is hosted at pi.hole/api" in the later v5-checks

[hudecitydave]

Same issue here - none of the workarounds helped...

[didyouexpectthat]

You need to check the first box ("uses an SSL certificate"). HTTP vs HTTPS; port 443 is HTTPS. And the location should be /admin

[abstarkeys]

I had the same problem but now it works. I installed pi-hole on an LXC from the proxmox community script, and by default there's no password required for the web interface. In the console on proxmox, i had to type "pihole setpassword" to set a password, and only then i was able to log in the integration with the API key. Then right after i got a log in issue, so i generated a new API key which I had to enter in Home Assistant a few times before it took it.