Multiple instances. One control plane.

FilterHelm is a self-hosted web app for managing several Pi-hole instances from one place.

Get started View on GitHub

Drift comparison across two Pi-hole instances, showing differing local DNS records and domain overrides. — FilterHelm shows the difference before it changes anything. Each Drift row links to the page that owns the entry, where you confirm the change for one instance.

How a change happens

Compare your instances on Drift to see which managed entries differ.
Follow the row’s Fix in link to the page that owns the entry.
Review the change and confirm it for one instance in its dialog.

Read more about the safety model.

Choose your path

Start hereInstall FilterHelm, add two instances, and open Drift.

GuidesChoose an install method and connect your instances.

ReferenceFind what each app page does and which Pi-hole versions it supports.

UnderstandSee how changes are confirmed and where the safety model ends.

What you need

Pi-hole FTL 6.x.
Docker or Podman, or Python 3.11 or newer to run from source.
An amd64 or arm64 host for the published image.

Read more about installation.

Get help

Ask a question or report a bug in GitHub issues.
Report vulnerabilities privately using the security reporting instructions.
Read the contributing guide before sending a change.