pihole-docker

this repository is to capture a working configuration of pi-hole DNS filter

required packages

-docker -docker-compose* -docker-ce*

for example:

docker-buildx-plugin/bookworm,now 0.20.0-1~debian.12~bookworm amd64 [installed,upgradable to: 0.21.0-1~debian.12~bookworm]
docker-ce-cli/bookworm,now 5:27.5.1-1~debian.12~bookworm amd64 [installed,upgradable to: 5:28.0.0-1~debian.12~bookworm]
docker-ce-rootless-extras/bookworm,now 5:27.5.1-1~debian.12~bookworm amd64 [installed,upgradable to: 5:28.0.0-1~debian.12~bookworm]
docker-ce/bookworm,now 5:27.5.1-1~debian.12~bookworm amd64 [installed,upgradable to: 5:28.0.0-1~debian.12~bookworm]
docker-compose-plugin/bookworm,now 2.32.4-1~debian.12~bookworm amd64 [installed,upgradable to: 2.33.0-1~debian.12~bookworm]
docker-compose/stable,now 1.29.2-3 all [installed]
docker/stable,now 1.5-2 all [installed]

docker-compose

The main configuration is in this file (docker-compose.yml) it is recommended to review it.

upgrade.sh

This takes care of initializing and upgrading, but also running, and will stop and start services as required.

Beware that this attempts to cleanup docker images, could be destructive on shared hosts.

mounted volumes

Familiarize yourself with these docker-volumes as they might be platform specific, keep in mind theyre not essential, but you need './pihole_fs/etc-pihole:/etc/pihole' for persistant storage.

volumes:
      - './pihole_fs/etc-pihole:/etc/pihole'
      - './pihole_fs/etc-dnsmasq.d:/etc/dnsmasq.d'
      - '/var/log/pihole:/var/log/pihole/'
      - '/etc/hosts:/etc/hosts'  # Host mappings (optional)
      - '/etc/localtime:/etc/localtime:ro'  # Keep system timezone synced

.env

this holds the following key items:

WEBPASSWORD=examplepass
SERVERIP=192.168.1.53

pihole_fs

create this folder in the current working directory if it doesnt exist, or map elsewhere in docker-compose.