{"id":15148410,"url":"https://github.com/origamiofficial/docker-pihole-bind9","last_synced_at":"2025-10-24T03:31:54.282Z","repository":{"id":133917947,"uuid":"589306144","full_name":"origamiofficial/docker-pihole-bind9","owner":"origamiofficial","description":"Pi-Hole \u0026 Bind on the same Docker container [Daily Updates]","archived":false,"fork":false,"pushed_at":"2024-08-04T06:41:47.000Z","size":80,"stargazers_count":4,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2024-09-27T13:03:32.635Z","etag":null,"topics":["bind","bind-dns","bind-dns-server","bind9","bind9-dns","bind9-dns-server","dns","dns-server","docker","docker-image","pi-hole","pi-hole-client","pi-hole-ftl","pi-hole-private-dns","pihole","pihole-bind","pihole-dashboard","pihole-docker"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/rlabinc/pihole-bind9","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/origamiofficial.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-01-15T18:42:44.000Z","updated_at":"2024-08-04T06:41:50.000Z","dependencies_parsed_at":"2023-05-19T16:00:31.536Z","dependency_job_id":"a013b5a0-66ae-4d30-9571-8c81ae8332b6","html_url":"https://github.com/origamiofficial/docker-pihole-bind9","commit_stats":null,"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/origamiofficial%2Fdocker-pihole-bind9","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/origamiofficial%2Fdocker-pihole-bind9/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/origamiofficial%2Fdocker-pihole-bind9/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/origamiofficial%2Fdocker-pihole-bind9/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/origamiofficial","download_url":"https://codeload.github.com/origamiofficial/docker-pihole-bind9/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219866820,"owners_count":16555824,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bind","bind-dns","bind-dns-server","bind9","bind9-dns","bind9-dns-server","dns","dns-server","docker","docker-image","pi-hole","pi-hole-client","pi-hole-ftl","pi-hole-private-dns","pihole","pihole-bind","pihole-dashboard","pihole-docker"],"created_at":"2024-09-26T13:03:35.813Z","updated_at":"2025-10-24T03:31:49.015Z","avatar_url":"https://github.com/origamiofficial.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# pihole-bind\n![Docker Pulls](https://img.shields.io/docker/pulls/rlabinc/pihole-bind9.svg?style=flat\u0026label=pulls\u0026logo=docker) ![Docker Image Size (tag)](https://img.shields.io/docker/image-size/rlabinc/pihole-bind9/latest?style=flat\u0026logo=docker\u0026label=pihole-bind9) ![Docker Image Size (tag)](https://img.shields.io/docker/image-size/pihole/pihole/latest?style=flat\u0026logo=docker\u0026label=pihole-official) [![Latest Build \u0026 Push](https://github.com/origamiofficial/docker-pihole-bind9/actions/workflows/build-and-push-latest.yaml/badge.svg)](https://github.com/origamiofficial/docker-pihole-bind9/actions/workflows/build-and-push-latest.yaml) ![GitHub Repo stars](https://img.shields.io/github/stars/origamiofficial/docker-pihole-bind9?style=social) ![We Support](https://img.shields.io/badge/we%20stand%20with-%F0%9F%87%B5%F0%9F%87%B8%20palestine-white.svg)\n\n[pihole-bind9](https://github.com/origamiofficial/docker-pihole-bind9) is a Docker container to run [Pi-Hole](https://github.com/pi-hole/pi-hole) \u0026 [Bind](https://gitlab.isc.org/isc-projects/bind9) on the same container.\n\n## Supported Architectures\n\nWe utilise the docker buildx for multi-platform awareness. More information is available from docker [here](https://docs.docker.com/buildx/working-with-buildx/).\n\nSimply pulling `rlabinc/pihole-bind9:latest` should retrieve the correct image for your arch, but you can also pull specific arch images via `--platform`.\n\nThe architectures supported by this image are:\n\n| Architecture | Available | Platform |\n| :----: | :----: | :----: |\n| x86-64 | ✅ | linux/amd64 |\n| arm64 | ✅ | linux/arm64 |\n| armhf | ✅ | linux/arm/v7 |\n| armv6 | ✅ | linux/arm/v6 |\n| i386 | ✅ | linux/386 |\n\n## Usage\nHere are the commands you'll need:\n```bash\ndocker run -d --name pihole-bind9 \\\n  --name=pihole-bind \\\n  -e TZ=Europe/London `#optional` \\\n  -p 53:53/tcp -p 53:53/udp \\\n  -p 80:80/tcp `#Pi-hole web interface port` \\\n  -e WEBPASSWORD='qwerty123' `#better to use single quotes` \\\n  -e DNSSEC_VALIDATE=auto \\\n  --restart=always \\\n  rlabinc/pihole-bind9:latest\n```\n\n### Docker Tags\nThe Docker tags supported by this image are:\n\n| Tag | Type |\n| :----: | :----: |\n| `latest` | Stable |\n| `date` | Stable |\n| `dev` | Beta |\n\nNote: Date tag images aren't the same as the official ones, they're based on the build date.\n\n### Installing on Ubuntu\nModern releases of Ubuntu (17.10+) include [`systemd-resolved`](http://manpages.ubuntu.com/manpages/bionic/man8/systemd-resolved.service.8.html) which is configured by default to implement a caching DNS stub resolver. This will prevent pi-hole from listening on port 53.\nThe stub resolver should be disabled with: `sudo sed -r -i.orig 's/#?DNSStubListener=yes/DNSStubListener=no/g' /etc/systemd/resolved.conf`\n\nThis will not change the nameserver settings, which point to the stub resolver thus preventing DNS resolution. Change the `/etc/resolv.conf` symlink to point to `/run/systemd/resolve/resolv.conf`, which is automatically updated to follow the system's [`netplan`](https://netplan.io/):\n`sudo sh -c 'rm /etc/resolv.conf \u0026\u0026 ln -s /run/systemd/resolve/resolv.conf /etc/resolv.conf'`\nAfter making these changes, you should restart systemd-resolved using `systemctl restart systemd-resolved`\n\nOnce pi-hole is installed, you'll want to configure your clients to use it ([see here](https://discourse.pi-hole.net/t/how-do-i-configure-my-devices-to-use-pi-hole-as-their-dns-server/245)). If you used the symlink above, your docker host will either use whatever is served by DHCP, or whatever static setting you've configured. If you want to explicitly set your docker host's nameservers you can edit the netplan(s) found at `/etc/netplan`, then run `sudo netplan apply`.\nExample netplan:\n```yaml\nnetwork:\n    ethernets:\n        ens160:\n            dhcp4: true\n            dhcp4-overrides:\n                use-dns: false\n            nameservers:\n                addresses: [127.0.0.1]\n    version: 2\n```\n\nNote that it is also possible to disable `systemd-resolved` entirely. However, this can cause problems with name resolution in vpns ([see bug report](https://bugs.launchpad.net/network-manager/+bug/1624317)). It also disables the functionality of netplan since systemd-resolved is used as the default renderer ([see `man netplan`](http://manpages.ubuntu.com/manpages/bionic/man5/netplan.5.html#description)). If you choose to disable the service, you will need to manually set the nameservers, for example by creating a new `/etc/resolv.conf`.\n\nUsers of older Ubuntu releases (circa 17.04) will need to disable dnsmasq.\n\n## Parameters\n\nContainer images are configured using parameters passed at runtime (such as those above).\n\n| Parameter | Function |\n| :----: | --- |\n| `-e TZ=Europe/London` | Specify a timezone to use EG Europe/London. |\n| `-p 53:53/tcp -p 53:53/udp` | Default DNS port to use. |\n| `-p 80:80/tcp` | Specify Pi-hole web interface port. |\n| `-e WEBPASSWORD='qwerty123'` | Specify Pi-hole web interface password. It is better to use single quotes. |\n| `-e DNSSEC_VALIDATE=auto` | This variable defines the DNSSEC validation in Bind. |\n| `--restart=always` | To make sure \"It's Always DNS\" does not happen. |\n\nThis Docker container supports both Pi-hole official Docker container all environment variables available [here](https://github.com/pi-hole/docker-pi-hole/#environment-variables) \u0026 cytopia's docker-bind Docker container all environment variables available [here](https://github.com/cytopia/docker-bind#-environment-variables).\n\n## Pihole Github Repository\nhttps://github.com/pi-hole/docker-pi-hole\n\n## Bind Github Repository\nhttps://gitlab.isc.org/isc-projects/bind9\n\n## Pi-hole Bind Github Repository\nhttps://github.com/origamiofficial/docker-pihole-bind9\n\n## Acknowledgements\nThe code in this image is heavily influenced by cytopia's docker-bind server Docker image configs,\nHowever, the upstream projects most certainly also deserve credit for making this all possible.\n- [pi-hole](https://github.com/pi-hole).\n- [NLnetLabs](https://github.com/NLnetLabs).\n- [cytopia](https://github.com/cytopia).\n- [chriscrowe](https://github.com/chriscrowe).\n\n## Warning\n\nI'm not responsible if your internet goes down using this Docker container. Use at your own risk.\n\n[![Hits](https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https://github.com/origamiofficial/docker-pihole-bind9\u0026icon=github.svg\u0026icon_color=%23FFFFFF\u0026title=hits\u0026edge_flat=false)](https://github.com/origamiofficial/docker-pihole-bind9)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Forigamiofficial%2Fdocker-pihole-bind9","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Forigamiofficial%2Fdocker-pihole-bind9","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Forigamiofficial%2Fdocker-pihole-bind9/lists"}