https://github.com/jsanchez0x/unbound_container
Simple implementation of unbound to work with Pi-Hole. Both in separate Docker containers.
https://github.com/jsanchez0x/unbound_container
docker docker-image pihole unbound
Last synced: 3 months ago
JSON representation
Simple implementation of unbound to work with Pi-Hole. Both in separate Docker containers.
- Host: GitHub
- URL: https://github.com/jsanchez0x/unbound_container
- Owner: jsanchez0x
- Created: 2022-07-05T21:19:54.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2026-03-03T08:04:54.000Z (4 months ago)
- Last Synced: 2026-03-03T11:49:44.605Z (4 months ago)
- Topics: docker, docker-image, pihole, unbound
- Language: Dockerfile
- Homepage: https://hub.docker.com/r/jsanchez0x/unbound_container
- Size: 138 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# unbound_container [](https://github.com/jsanchez0x/unbound_container/actions/workflows/docker-image.yml) [](https://hub.docker.com/r/jsanchez0x/unbound_container)
Simple implementation of [unbound](https://www.nlnetlabs.nl/projects/unbound/about/) to work with [Pi-Hole](https://pi-hole.net/). Both in separate Docker containers.
## Prerequisites
If the Pi-hole container is running on a network other than the default. If not, this is not necessary.
- Get the name of the network where the Pi-Hole container is located.
- And set an unused IP of this network.
## Build
```bash
git clone https://github.com/jsanchez0x/unbound_container.git
docker build --rm --tag jsanchez0x/unbound_container:latest unbound_container
```
## Run
```bash
docker run -d \
--name unbound \
-p 5335:5335/tcp -p 5335:5335/udp \
--restart=unless-stopped \
--cap-add=NET_ADMIN \
jsanchez0x/unbound_container:latest
```
### With custom network
Assuming that the network name is called *pihole-network* and the IP *172.18.0.4* is not used.
```bash
docker run -d \
--name unbound \
-p 5335:5335/tcp -p 5335:5335/udp \
--net pihole-network --ip 172.18.0.4 \
--restart=unless-stopped \
--cap-add=NET_ADMIN \
jsanchez0x/unbound_container:latest
```
## Maintenance
Re-create every 6 months to update the root servers. Necessary to download updated [dns-root-data](https://packages.debian.org/sid/dns-root-data).