silvermind/balena-pihole

raspberrypi3 balenaCloud stack with Pi-hole, PADD, & dnscrypt-proxy

balena-pihole

If you're looking for a way to quickly and easily get up and running with a Pi-hole device for your home network, this is the project for you.

This project is a balenaCloud stack with the following services:

• Pi-hole (including PADD)
• dnscrypt-proxy (optional)

balenaCloud is a free service to remotely manage and update your Raspberry Pi through an online dashboard interface, as well as providing remote access to the Pi-hole web interface without any additional configuation.

Getting Started

You can one-click-deploy this project to balena using the button below:

Manual Deployment

Alternatively, deployment can be carried out by manually creating a balenaCloud account and application, flashing a device, downloading the project and pushing it via either Git or the balena CLI.

Device Variables

Device Variables apply to all services within the application, and can be applied fleet-wide to apply to multiple devices. If you used the one-click-deploy method, the default environment variables will already be added for you to customize as needed.

Name	Example	Purpose
TZ	America/Toronto	To inform services of the timezone in your location, in order to set times and dates within the applications correctly. Find a list of all timezone values here.
DNSMASQ_LISTENING	eth0	We set this to eth0 to indicate we want DNSMASQ to listen on the ethernet interface of the Raspberry Pi. If you're connecting to your network with WiFi replace this with wlan0
INTERFACE	eth0	As above.
WEBPASSWORD	mysecretpassword	(optional) password for accessing the web-based interface of Pi-hole - you won’t be able to access the admin panel without defining a password here.
DNS1	127.0.0.1#5053	(optional) Tell Pi-hole where to forward DNS requests that aren’t blocked. We’re using the dnscrypt-proxy project here but you can specify your own.
DNS2	127.0.0.1#5053	(optional) Secondary DNS server - see above.
ServerIP	x.x.x.x	(recommended) Set to your server's LAN IP, used by web block modes and lighttpd bind address.

Usage

• https://www.balena.io/blog/deploy-network-wide-ad-blocking-with-pi-hole-and-a-raspberry-pi/
• https://github.com/DNSCrypt/dnscrypt-proxy/wiki

Help

If you're having trouble getting the project running, submit an issue or post on the forums at https://forums.balena.io.

Author

Kyle Harding https://klutchell.dev

Buy me a beer

Buy me a craft beer

Acknowledgments

• https://github.com/pi-hole/docker-pi-hole/
• https://github.com/DNSCrypt/dnscrypt-proxy

License

MIT License