# pi-hole/pi-hole

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/pi-hole-pi-hole).**

59,314 stars · 3,228 forks · Shell · NOASSERTION

## Links

- GitHub: https://github.com/pi-hole/pi-hole
- Homepage: https://pi-hole.net
- awesome-repositories: https://awesome-repositories.com/repository/pi-hole-pi-hole.md

## Topics

`ad-blocker` `blocker` `cloud` `dashboard` `dhcp` `dhcp-server` `dns-server` `dnsmasq` `pi-hole` `raspberry-pi` `shell`

## Description

Pi-hole is a self-hosted network utility that functions as a DNS sinkhole server to provide network-wide ad blocking. By acting as a dedicated network gateway, it intercepts and discards requests for known advertising, tracking, and malicious domains across an entire local network, preventing unwanted content from loading on any connected device.

The software operates through a lightweight background daemon that handles high volumes of concurrent DNS queries with minimal resource overhead. It utilizes a host-file injection mechanism to redirect traffic toward its local filtering engine and applies regex-based pattern matching to identify and block specific domain requests. Users manage these operations and monitor network traffic statistics through a centralized, web-based configuration interface.

Beyond blocking, the project provides tools for comprehensive DNS traffic management and home network security. By resolving domain names locally, it offers increased visibility into outgoing internet traffic and helps optimize network performance by preventing the download of resource-heavy tracking scripts and advertisements.

## Tags

### Networking & Communication

- [DNS-Based Ad Blockers](https://awesome-repositories.com/f/networking-communication/network-infrastructure-routing/network-infrastructure-configuration/network-infrastructure/dns-based-ad-blockers.md) — Intercepts and drops DNS requests for known advertising and tracking domains to prevent unwanted content from loading.
- [DNS Daemons](https://awesome-repositories.com/f/networking-communication/network-infrastructure-routing/network-infrastructure-configuration/network-infrastructure/dns-daemons.md) — Runs as a lightweight background daemon to manage domain name resolution requests with minimal system overhead.
- [Recursive DNS Resolvers](https://awesome-repositories.com/f/networking-communication/network-infrastructure-routing/network-infrastructure-configuration/network-infrastructure/recursive-dns-resolvers.md) — Acts as a central gateway that resolves domain names locally to enhance privacy and bypass external tracking attempts.
- [DNS Traffic Managers](https://awesome-repositories.com/f/networking-communication/network-infrastructure-routing/network-infrastructure-configuration/network-infrastructure/dns-traffic-managers.md) — Gains visibility into outgoing internet traffic by monitoring how connected devices resolve domain names.
- [Network Performance Optimizers](https://awesome-repositories.com/f/networking-communication/network-infrastructure-routing/network-utilities/network-performance-optimizers.md) — Speeds up page load times and reduces bandwidth consumption by preventing resource-heavy advertisements from being downloaded.
- [Regex Filtering Engines](https://awesome-repositories.com/f/networking-communication/network-reliability-diagnostics/network-filtering/regex-filtering-engines.md) — Applies regular expression patterns to incoming DNS queries to identify and block requests associated with advertising or tracking.

### Security & Cryptography

- [DNS Filtering Solutions](https://awesome-repositories.com/f/security-cryptography/network-infrastructure-security/web-network-security/network-security-tools/dns-filtering-solutions.md) — Discarding DNS queries for specific domains or content categories ensures that restricted traffic never reaches the local network.
- [DNS Sinkholes](https://awesome-repositories.com/f/security-cryptography/network-infrastructure-security/web-network-security/network-security-tools/dns-sinkholes.md) — Redirects queries for malicious or unwanted domains to a null address, effectively preventing connections to those servers.
- [Network Ad Blockers](https://awesome-repositories.com/f/security-cryptography/network-infrastructure-security/web-network-security/network-security-tools/network-ad-blockers.md) — Blocks advertisements and tracking scripts across every connected device by filtering traffic at the DNS level. ([source](https://docs.pi-hole.net/))
- [Network Security Tools](https://awesome-repositories.com/f/security-cryptography/network-infrastructure-security/web-network-security/network-security-tools.md) — Protects connected devices from malicious activity by intercepting and blocking suspicious requests before they enter the network.

### DevOps & Infrastructure

- [Network Utilities](https://awesome-repositories.com/f/devops-infrastructure/self-hosted-applications/network-utilities.md) — Centralizes control over domain resolution and traffic filtering for all hardware within a home or office network.

### System Administration & Monitoring

- [Host File Managers](https://awesome-repositories.com/f/system-administration-monitoring/administrative-operations/configuration-control-utilities/system-administration-tools/system-configuration/host-file-managers.md) — Maintains system-level mapping files to programmatically redirect network traffic toward a local filtering engine.
- [Network Administration Dashboards](https://awesome-repositories.com/f/system-administration-monitoring/administrative-operations/remote-access-interface-tools/administrative-interfaces/management-interfaces/network-administration-dashboards.md) — Visualizes network traffic statistics and manages configuration settings through an integrated web-based administrative interface.

### Part of an Awesome List

- [DNS Management](https://awesome-repositories.com/f/awesome-lists/devops/dns-management.md) — Network-wide ad blocking with a management GUI.
- [Infrastructure Services](https://awesome-repositories.com/f/awesome-lists/devops/infrastructure-services.md) — Network-wide DNS sinkhole for blocking unwanted content.
- [Network Infrastructure](https://awesome-repositories.com/f/awesome-lists/devops/network-infrastructure.md) — Network-wide ad-blocking via DNS sinkholing.
- [Systems And Services](https://awesome-repositories.com/f/awesome-lists/devops/systems-and-services.md) — Listed in the “Systems And Services” section of the The Book Of Secret Knowledge awesome list.
- [Internet Services](https://awesome-repositories.com/f/awesome-lists/media/internet-services.md) — Network-level advertisement and tracker blocking via DNS.
- [Ad Blockers](https://awesome-repositories.com/f/awesome-lists/security/ad-blockers.md) — Network-wide ad-blocking software for local infrastructure.
