Pi-hole

UNOFFICIAL

The Pi-hole project maintainers do not yet support snap-based installations. You can ask questions and report issues about the snap package here:

https://github.com/rajannpatel/snap-pi-hole/issues

INSTALLATION

Install the package

sudo snap install pihole-by-rajannpatel

Command aliases

sudo snap alias pihole-by-rajannpatel.pihole pihole

sudo snap alias pihole-by-rajannpatel.check-system pihole.check-system

sudo snap alias pihole-by-rajannpatel.health pihole.health

sudo snap alias pihole-by-rajannpatel.status pihole.status

sudo snap alias pihole-by-rajannpatel.debug pihole.debug

sudo snap alias pihole-by-rajannpatel.snapdebug pihole.snapdebug

Free up port 53

The local DNS resolver service in Ubuntu, systemd-resolved, securely binds to port 53 by default. You must disable its stub listener to free port 53 before starting Pi-hole:

sudo mkdir -p /etc/systemd/resolved.conf.d

printf '[Resolve]\nDNSStubListener=no\n' | sudo tee /etc/systemd/resolved.conf.d/pihole.conf

sudo systemctl restart systemd-resolved

Connect snap interfaces

# [REQUIRED] Allow Pi-hole to bind to port 53 (DNS) and 80/443 (Web Interface)

sudo snap connect pihole-by-rajannpatel:network-bind

# [REQUIRED] Allow Pi-hole to observe system network interfaces for configuration

sudo snap connect pihole-by-rajannpatel:network-observe

# [OPTIONAL] Allow Pi-hole to enforce accurate time synchronization for DNSSEC validation

sudo snap connect pihole-by-rajannpatel:time-control

# [OPTIONAL] Allow Pi-hole to elevate its DNS resolution threads to real-time priority

sudo snap connect pihole-by-rajannpatel:process-control

# [OPTIONAL] Allow the Web Dashboard to read and display host CPU, RAM, and disk telemetry

sudo snap connect pihole-by-rajannpatel:system-observe

sudo snap connect pihole-by-rajannpatel:hardware-observe

sudo snap connect pihole-by-rajannpatel:mount-observe

# [OPTIONAL] Elevate permissions for DHCP broadcasting if Pi-hole is your router

sudo snap connect pihole-by-rajannpatel:network-control

sudo snap connect pihole-by-rajannpatel:firewall-control

Enable the daemon

sudo snap start --enable pihole-by-rajannpatel.pihole-ftl

Access the dashboard

Navigate to the web interface in your browser:

http://<Pi-hole-IP>/admin

MORE INFORMATION

Documentation

https://github.com/rajannpatel/snap-pi-hole/wiki

Tutorial

https://github.com/rajannpatel/snap-pi-hole/wiki/Tutorial:-Getting-Started

How-To Guides

https://github.com/rajannpatel/snap-pi-hole/wiki/How-To:-Supported-Deployment-Patterns

Configuration Reference

https://github.com/rajannpatel/snap-pi-hole/wiki/Reference:-Native-Configuration

Explanation

https://github.com/rajannpatel/snap-pi-hole/wiki/Explanation:-Architecture-and-Rationale