A Docker container built on Debian to run pi-hole ad filter
GitHub repository: https://github.com/lp-lab/dockerPiHole
Issues reports: https://github.com/lp-lab/dockerPiHole/issues
This container accepts a number of variables passed by Docker command line via
-e switch
| Variable | Default value | Description |
|---|---|---|
| ServerIP | NONE - REQUIRED | The IP address of the pi-hole container |
| ADMIN_PASS | NONE - REQUIRED | The admin password for the pi-hole web interface |
| DNS1 | 8.8.8.8 - Google | Primary DNS |
| DNS2 | 8.8.4.4 - Google | Secondary DNS |
docker run -p 53:53 -p 53:53/udp -p 80:80 -d --name pihole -e ADMIN_PASS="reallysecurepassword" -e DNS1="10.0.0.1" -e DNS2="10.0.0.2" -e ServerIP="10.0.0.3" lplab/pihole:latest
The bare minimum to run this container is:
docker run -p 53:53 -p 53:53/udp -p 80:80 -d --name pihole -e ADMIN_PASS="reallysecurepassword" -e ServerIP="IP.ADDRESS.OF.CONTAINER" lplab/pihole:latest
it will start the container and automatically update the blocked domain list.
Starting with version 2.0.2, even /var/log is automatically binded to a docker volume, so there's no need to mount it from command line
Starting with version 2.0.0 of this container, released on June 16th 2017, pihole-FTL uses a sqlite DB to store queries, located on /etc/pihole directory, so the container now automatically creates a volume to store this directory, there's no need to mount any file in /etc/pihole and can be safely removed from the command line
There are some useful volume mounts, passed via -v switch to the Docker
command line:
-v /etc/localtime:/etc/localtime:ro-v /etc/timezone:/etc/timezone:ro
to allow the container to use your system timezone, for query graph renders.
-v /srv/pihole/etc/hosts:/etc/hosts
for manual adding of certain hostname.
Always remember to mkdir/touch directory and files before the container startup or Docker will create directory for every mount.
To upgrade download the new version from Docker's hub
docker pull lplab/pihole:latest
then stop the running container
docker rm -f pihole
and restart the new pihole using the same command line as above.