---
title: "Pi-hole"
description: "Pi-hole is a built-in integration for Home Assistant. It has 7.2k installs sharing analytics and works locally."
canonical: "https://vulpo.app/integrations/core/pi-hole"
url: "https://vulpo.app/integrations/core/pi-hole.md"
last-updated: "2026-10-22"
version: "1.4"
---

# Pi-hole

> Pi-hole is a built-in integration for Home Assistant. It has 7.2k installs sharing analytics and works locally.

Pi-hole is a built-in integration that connects Home Assistant to a Pi-hole DNS ad blocker over the local network. It adds a status binary sensor, sensors for ads blocked, DNS queries, clients, domains and blocked percentages, and update entities for the core, FTL and web components. Switches are also provided, and an action can disable the configured Pi-hole for a set amount of time. Setup happens in the UI and asks for an app password or API key, host, port, location, and SSL options. A repair notice appears after a migration from Pi-hole API v5 to v6, and a diagnostics file can be downloaded for bug reports.

Automatic summary of Home Assistant's source code. Something wrong? [Get in touch](https://vulpo.app/contact)

[Open in My Home Assistant](https://my.home-assistant.io/redirect/config_flow_start/?domain=pi_hole)

## Supports

- **Works locally**: Talks to your devices on your own network. No vendor cloud in between.
- **Set up in the UI**: Add it in Settings, Devices and services. Nothing to download.
- **Updated with Home Assistant**: Ships and updates with every Home Assistant release.

## Setting it up

It is added under Settings, Devices and services, with Add integration.

### Connect

- **App password or API key**
- **Host**
- **Location**
- **Port**
- **Uses an SSL certificate**
- **Verify SSL certificate**

### Reauthenticate Pi-hole

- **API key**

Texts from Home Assistant's source code, [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).

## Entities

- **Binary sensors**: Status
- **Sensors**: Ads blocked, Ads blocked today, Ads percentage blocked today, Seen clients, DNS queries, DNS queries today, Domains blocked, Ads percentage blocked, DNS queries cached, DNS queries forwarded, DNS unique clients, DNS unique domains
- **Updates**: Core update available, FTL update available, Web update available

## Actions

- **Disable**: Disables configured Pi-hole(s) for an amount of time.
  Fields: Duration

## Troubleshooting

- **Diagnostics**: Downloads a diagnostics file to attach to a bug report.
- **Repair notices**: Notices it can show in Settings, Repairs:
  Recent migration from Pi-hole API v5 to v6

## At a glance

- Kind: Built-in integration
- Category: [Computers and network](https://vulpo.app/integrations/category/computers-and-network.md), Routers and network
- Brand: [Pi-hole](https://vulpo.app/integrations/pi-hole.md)
- Number: 7.2k installs sharing analytics
- Connection: Works locally
- Upkeep: Part of Home Assistant
- Needs: Built into Home Assistant
- Domain: `pi_hole`
- Source: <https://www.home-assistant.io/integrations/pi_hole/>

In Vulpo: Quick Toggle card, Chart card, Apple Watch, Control Center

## Other ways in for Pi-hole

| Name | Kind | Installs or stars | Connection | Upkeep |
| --- | --- | --- | --- | --- |
| [Pi-hole V6 Integration](https://vulpo.app/integrations/marketplace/bastgau-ha-pi-hole-v6.md) | Marketplace integration | 1.9k installs sharing analytics | Works locally | Updated in the last 6 months |
| [Pi‑hole Presence](https://github.com/lrehmann/pihole_presence) | Marketplace integration | 13 installs sharing analytics | Works locally | Updated in the last 6 months |
| [Pi-hole Card](https://vulpo.app/integrations/cards/homeassistant-extras-pi-hole-card.md) | Dashboard card | 176 GitHub stars | Connection not stated | Updated in the last 6 months |

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about)

Last updated 2026-10-22. Source: https://vulpo.app/integrations/core/pi-hole

---

- HTML version of this page: https://vulpo.app/integrations/core/pi-hole
- Site index for agents: https://vulpo.app/llms.txt
- Everything in one document: https://vulpo.app/llms-full.txt
- All pages: https://vulpo.app/sitemap.xml