Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/l33tlamer/pihole-unbound
Example setup of Pihole with Unbound
https://github.com/l33tlamer/pihole-unbound
docker pihole unbound
Last synced: 18 days ago
JSON representation
Example setup of Pihole with Unbound
- Host: GitHub
- URL: https://github.com/l33tlamer/pihole-unbound
- Owner: l33tlamer
- Created: 2024-06-29T04:35:28.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2024-10-13T03:33:57.000Z (3 months ago)
- Last Synced: 2024-11-02T07:05:59.039Z (2 months ago)
- Topics: docker, pihole, unbound
- Homepage:
- Size: 46.9 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Example of Pihole (v5) with Unbound using Docker
Using [official Pihole Docker image](https://hub.docker.com/r/pihole/pihole) and [mvance/unbound](https://github.com/MatthewVance/unbound-docker) for [Unbound](https://nlnetlabs.nl/projects/unbound/about/).
**This is not a guide. This should only serve you as a example for your own setup.**
Some basic **Docker** and networking knowledge is expected.
With this config Unbound would act as a **recursive resolver**.
After **cloning** this repo, your structure should look like this:
```
├── compose.yaml
└── required
└── dnsmasq.d
├── 09-pihole-local-subdomains.conf
├── 10-pihole-dhcp.conf
└── unbound
├── a-records.conf
├── forward-records.conf
├── srv-records.conf
└── unbound.conf
```
* Modify the `compose.yaml` to suit your setup. Note the **WebUI password**.
* If you are using a **Raspberry Pi** (or similar), change `image: mvance/unbound:latest` into `image: mvance/unbound-rpi:latest`
* Modify `required/unbound/unbound.conf` to suit your setup.
* Bring up your stack with `docker compose up -d`
* In Pihole WebUI, make sure Unbound is set as upstream DNS with IPv4 `127.0.0.1#5353` (note the #).
The files `required/dnsmasq.d/09-pihole-local-subdomains.conf` and `required/dnsmasq.d/10-pihole-dhcp.conf`
are empty placeholders for when you want to customize Pihole with that.
Example content of `09-pihole-local-subdomains.conf` to create custom local wildcard subdomains:
```
address=/.home.example.com/192.168.20.80
```
Example content for `10-pihole-dhcp.conf` to supply additinal options to Pihole´s DHCP server:
```
### give out two DNS (option 6) servers through DHCP
dhcp-option=6,192.168.20.50,192.168.20.51
### give out specific IP for NTP (option 42)
dhcp-option=42,192.168.20.40
### define tags for devices that will receive Google DNS instead through DHCP
dhcp-option=tag:googlednsv4,6,8.8.8.8,8.8.4.4
### assign above tag to a specific device by MAC
dhcp-host=AB:AB:AB:AB:AB:AB,set:googlednsv4
```
The files `required/unbound/a-records.conf`, `required/unbound/forward-records.conf`
and `required/unbound/srv-records.conf` are empty placeholders for when you want to add those custom records to Unbound.
**This is not a guide. This should only serve you as a example for your own setup.**
Note that *mvance/unbound* & *mvance/unbound-rpi* are a bit slow with releasing new images for **new Unbound versions**.
If thats a problem for your setup, find a different image to use, or better yet, **build your own**.
**Please refer to the documentation of Pihole, the unbound image and Unbound itself.**
* https://pi-hole.net/
* https://github.com/MatthewVance/unbound-docker/
* https://nlnetlabs.nl/projects/unbound/about/