Pi-hole Homebridge plugin

Pi-hole

homebridge-pihole · v1.1.0

VerifiedLocalHomebridge 2.0

Adds a switch to disable Pi-hole.

View on npm Source code

What it says it supports

Brands

Pi-hole

Shows up in Apple Home as from its README

Switches

What people report

Pi-hole enable/disable switch. Pi-hole v6 API change broke it; a 1.0.2 beta targets Node 24 but multi-instance errors were reported.

Partly works1

Device	Status	What they said	Source
Pi-hole v6	Partly works	Switch broke with v6; beta adds support but second instance fails Saved copy I have to correct, now the first pihole didn't response anymore ... even with new install an without client bridge mode: [12/30/2025, 5:51:43 PM] [Pi-Hole-1] Error TypeError: Cannot read properties of undefined (reading 'valid') at PiholeClient.setupSession (/usr/lib/node_modules/homebridge-pihole/src/piholeClient.ts:113:22) at processTicksAndRejections (node:internal/process/task_queues:103:5) at PiholeClient.getBlocking (/usr/lib/node_modules/homebridge-pihole/src/piholeClient.ts:130:3) at On.getHandler (/usr/lib/node_modules/homebridge-pihole/src/index.ts:61:23) [12/30/2025, 5:51:43 PM] … Excerpt saved from GitHub on 2026-10-22.	Issue #93 · 2025-11

Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Local

Pi-hole API

You’ll need

Pi-hole

Compatibility

Verified by Homebridge	Yes
Homebridge versions	^1.6.0 \|\| ^2.0.0-beta.0
Homebridge 2.0	Yes
Node.js	^20.7.0 \|\| ^22 \|\| ^24
Settings in Homebridge UI	Yes
Matter	No
Platform name	Pihole
License	MIT

Community signals

Downloads a week	22
Downloads a month	127
GitHub stars	178
Open issues	1
Closed issues	50
Discussions	6
Last code push	2026-04-02
Latest version	1.1.0 (2026-01-01)
First published	2019-10-18
Releases	32

In ReReHome

Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.

Bridges get their own settings page listing the accessories behind them.

HomeKit services in its code

Found by scanning the published npm package. A plugin can register a service only for some devices.

Switch

Sources

npm: https://www.npmjs.com/package/homebridge-pihole
Source code: https://github.com/arendruni/homebridge-pihole
Issues: https://github.com/arendruni/homebridge-pihole/issues
Verified plugins list: https://github.com/homebridge/verified