# Deploy Pi-hole with Easypanel

URL: /templates/pihole

Pi-hole is a network-wide ad blocker that acts as a DNS sinkhole to protect your devices from unwanted content without installing any client-side software. It blocks ads at the DNS level, meaning ads are blocked before they even reach your devices, resulting in faster browsing, reduced bandwidth usage, and enhanced privacy. Pi-hole provides a powerful web interface for easy management and detailed statistics about your network's DNS queries. It can block millions of ad-serving domains and supports custom block lists. The application also includes features like DHCP server capabilities, DNS-over-HTTPS (DoH) support, and comprehensive query logging. With Pi-hole, you can monitor all DNS requests on your network, see which domains are being blocked, and maintain complete control over your network's DNS filtering.

## Installation notes

After the deployment of the Pi-Hole Service, it might not start straight away, you have to stop the systemd-resolved.service, or service which would be occupying the DNS port 53, make sure you also disable that so it doesn't starts on boot.

## Benefits

### Network-Wide Ad Blocking

Pi-hole blocks ads at the DNS level for all devices on your network without requiring any client-side software installation.

### Faster Browsing Experience

By blocking ads before they load, Pi-hole reduces bandwidth usage and speeds up page loading times across all your devices.

### Enhanced Privacy Protection

Pi-hole blocks tracking domains and prevents third-party services from collecting data about your browsing habits and online activities.

### Comprehensive Network Monitoring

Monitor all DNS queries on your network with detailed statistics and logs, giving you complete visibility into network activity.

## Features

### DNS-Level Ad Blocking

Pi-hole intercepts DNS requests and blocks domains known for serving ads, trackers, and malicious content before they reach your devices.

### Intuitive Web Interface

Manage your Pi-hole installation through a user-friendly web interface with real-time statistics, query logs, and configuration options.

### Custom Block Lists

Add custom block lists and whitelist specific domains to tailor the filtering to your specific needs and preferences.

### DHCP Server Support

Pi-hole includes a built-in DHCP server that can replace your router's DHCP server for seamless network integration.

### Query Logging and Analytics

View detailed logs of all DNS queries, see which domains are being blocked, and analyze your network's DNS traffic patterns.

## Configuration

- `appServiceName` (App Service Name, required): pihole

- `appServiceImage` (App Service Image, required): pihole/pihole:2024.07.0

- `timezone` (Timezone, required): Europe/Vienna

- `webPassword` (Web Password): webPassword!@#123

## Services

- pihole: app (pihole/pihole:2024.07.0)

## Resources

- [Website](https://pi-hole.net/)

- [Documentation](https://docs.pi-hole.net/)

- [GitHub](https://github.com/pi-hole/pi-hole)

- [Docker](https://hub.docker.com/r/pihole/pihole)

- [Template source](https://github.com/easypanel-io/templates/tree/main/templates/pihole)