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:
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 configuration.
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 |
|---|---|---|
|
|
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. |
|
|
We set this to |
|
|
As above. |
|
|
(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. |
|
|
(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. |
|
|
(optional) Secondary DNS server - see above. |
|
|
(recommended) Set to your server’s LAN IP, used by web block modes and lighttpd bind address. |
Usage¶
Help¶
If you’re having trouble getting the project running, submit an issue or post on the forums at https://forums.balena.io.