this repository is to capture a working configuration of pi-hole DNS filter
-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]The main configuration is in this file (docker-compose.yml) it is recommended to review it.
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.
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 syncedthis holds the following key items:
WEBPASSWORD=examplepass
SERVERIP=192.168.1.53create this folder in the current working directory if it doesnt exist, or map elsewhere in docker-compose.