e26a459bf3
* remove uneeded 1.1.1.1 dns entry I noticed that the 1.1.1.1 dns entry is set in the docker compose file but it is not used for pihole or unbound in any way so makes sense to remove the unneeded entry * Update docker-compose.yaml Removing `dns` directive from docker-compose Co-authored-by: Chris Crowe <425808+chriscrowe@users.noreply.github.com> |
||
---|---|---|
.. | ||
pihole-unbound | ||
docker-compose.yaml | ||
README.md |
Pi-Hole + Unbound - 1 Container
Description
This Docker deployment runs both Pi-Hole and Unbound in a single container.
The base image for the container is the official Pi-Hole container, with an extra build step added to install the Unbound resolver directly into to the container based on instructions provided directly by the Pi-Hole team.
Usage
First create a .env
file to substitute variables for your deployment.
Required environment variables
Vars and descriptions replicated from the official pihole container:
Docker Environment Var | Description |
---|---|
ServerIP: <Host's IP> |
--net=host mode requires Set to your server's LAN IP, used by web block modes and lighttpd bind address |
TZ: <Timezone> |
Set your timezone to make sure logs rotate at local midnight instead of at UTC midnight. |
WEBPASSWORD: <Admin password> |
http://pi.hole/admin password. Run docker logs pihole | grep random to find your random pass. |
REV_SERVER: <"true"|"false"> |
Enable DNS conditional forwarding for device name resolution |
REV_SERVER_DOMAIN: <Network Domain> |
If conditional forwarding is enabled, set the domain of the local network router |
REV_SERVER_TARGET: <Router's IP> |
If conditional forwarding is enabled, set the IP of the local network router |
REV_SERVER_CIDR: <Reverse DNS> |
If conditional forwarding is enabled, set the reverse DNS zone (e.g. 192.168.0.0/24 ) |
Example .env
file in the same directory as your docker-compose.yaml
file:
ServerIP=192.168.1.10
TZ=America/Los_Angeles
WEBPASSWORD=QWERTY123456asdfASDF
REV_SERVER=true
REV_SERVER_DOMAIN=local
REV_SERVER_TARGET=192.168.1.1
REV_SERVER_CIDR=192.168.0.0/16
HOSTNAME=pihole
DOMAIN_NAME=pihole.local
Using Portainer stacks?
Portainer stacks are a little weird and don't want you to declare your named volumes, so remove this block from the top of the docker-compose.yaml
file before copy/pasting into Portainer's stack editor:
volumes:
etc_pihole-unbound:
etc_pihole_dnsmasq-unbound:
Running the stack
docker-compose up -d
If using Portainer, just paste the
docker-compose.yaml
contents into the stack config and add your environment variables directly in the UI.