homepage/docs/widgets/services/pihole.md

---
title: PiHole
description: PiHole Widget Configuration
---

Learn more about [PiHole](https://github.com/pi-hole/pi-hole).

Allowed fields: `["queries", "blocked", "blocked_percent", "gravity"]`.

Note: by default the "blocked" and "blocked_percent" fields are merged e.g. "1,234 (15%)" but explicitly including the "blocked_percent" field will change them to display separately.

```yaml
widget:
  type: pihole
  url: http://pi.hole.or.ip
  version: 6 # required if running v6 or higher, defaults to 5
  key: yourpiholeapikey # optional, in v6 can be your password or app password
```
add mkdocs 2023-09-29 21:01:11 +03:00			`---`
			`title: PiHole`
			`description: PiHole Widget Configuration`
			`---`

Make service links less weird 2024-01-24 14:27:47 -08:00			`Learn more about [PiHole](https://github.com/pi-hole/pi-hole).`
Documentation: add project links to service widget docs (#2737) 2024-01-22 13:26:15 -05:00
add mkdocs 2023-09-29 21:01:11 +03:00			Allowed fields: `["queries", "blocked", "blocked_percent", "gravity"]`.

Change: default merge pihole blocked fields (#3065) 2024-03-04 11:09:36 -08:00			`Note: by default the "blocked" and "blocked_percent" fields are merged e.g. "1,234 (15%)" but explicitly including the "blocked_percent" field will change them to display separately.`

add mkdocs 2023-09-29 21:01:11 +03:00			```yaml
			`widget:`
Run pre-commit hooks over existing codebase Co-Authored-By: Ben Phelps <ben@phelps.io> 2023-10-17 23:26:55 -07:00			`type: pihole`
			`url: http://pi.hole.or.ip`
Feature: Support pi-hole v6 (#3207) 2024-03-31 20:34:46 -07:00			`version: 6 # required if running v6 or higher, defaults to 5`
Documentation: add correct pihole v6 password info 2024-10-28 12:27:11 -07:00			`key: yourpiholeapikey # optional, in v6 can be your password or app password`
add mkdocs 2023-09-29 21:01:11 +03:00			```