docker-pihole-unbound/README.md

70 lines
3 KiB
Markdown
Raw Normal View History

2019-02-05 06:01:38 +01:00
# Pi-Hole + Unbound on Docker
#### (Synology-compatible!)
## Description
Running Pi-Hole in Docker can be challenging due to networking requirements by Pi-Hole, this is especially true when the ports that Pi-Hole uses are shared by the host it's running on (this is true for Synology in the default configuration).
This project uses a [`macvlan` Docker network](https://docs.docker.com/network/macvlan/) to place your containers on your main network, with their own IP addresses and MAC addresses. Pi-Hole uses Unbound as it's resolver, and Unbound uses Cloudflare (1.1.1.1) upstream in order to support DNSSEC and DNS-over-TLS.
2019-02-05 06:01:38 +01:00
- This docker-compose runs the following 2 containers
- Pi-Hole ([pihole/pihole](https://hub.docker.com/r/pihole/pihole)) - Official from Pi-Hole
2019-02-05 06:01:38 +01:00
- Unbound ([mvance/unbound](https://hub.docker.com/r/mvance/unbound)) - There are several choices here but I like this one the best
2019-02-03 02:04:08 +01:00
## Instructions
2019-02-05 06:01:38 +01:00
### Hold your horses and configure some stuff first...
2019-02-05 06:01:38 +01:00
- Update docker-compose to match your environment, eg. IP addresses/subnets.
2019-02-05 06:08:14 +01:00
- Take note of the `networks.home.driver_opts.parent` value, the default value of `ovs_eth1` is for using the 2nd ethernet port on a Synology NAS with `Open vSwitch` enabled, if disabled use `eth1` instead, or whichever other interface you might be using in your setup.
2019-02-05 06:01:38 +01:00
- Add a `.env` file next to the docker-compose.yaml so you can pass in the `${WEBPASSWORD}` - this is your Pi-Hole admin password. You can optionally leave this step out and set the password via CLI (`pihole -a -p`) after the Pi-Hole is running
- Update the secondary/backup nameserver in the `resolv.conf` file, or remove it if you don't have a backup (would recommend having one!)
- Lastly, optionally, you can provide some manual DNS entries in the `dnsmasq.conf` and/or `hosts` files
2019-02-03 02:04:08 +01:00
### Run it!
```bash
sudo docker-compose up -d
```
2019-02-03 02:04:08 +01:00
### Test it!
2019-02-05 06:01:38 +01:00
Test your configuration with dig
> __Note__: change the IP to your new Pi-Hole's IP
```bash
2019-02-03 01:54:52 +01:00
dig google.com @192.168.1.248
# Expecting "status: NOERROR"
```
You can also test for DNSSEC functionality:
```bash
2019-02-03 01:54:52 +01:00
dig sigfail.verteiltesysteme.net @192.168.1.248
# Expecting "status: SERVFAIL"
2019-02-03 01:54:52 +01:00
dig sigok.verteiltesysteme.net @192.168.1.248
# Expecting "status: NOERROR"
```
2019-02-03 02:04:08 +01:00
### Serve it!
If all looks good, configure your router/DHCP server to serve your new Pi-Hole IP address (`192.168.1.248`) to your clients.
2019-02-05 06:01:38 +01:00
> Note: it may take some time for the current DHCP leases to renew and for clients to get the new DNS service info -- generally the default is 24 hours or less.
2019-02-03 02:04:08 +01:00
## Acknowledgements
2019-02-03 01:36:02 +01:00
2019-02-03 02:06:50 +01:00
- [http://tonylawrence.com/posts/unix/synology/free-your-synology-ports/][synology-ports]
- [https://github.com/MatthewVance/unbound-docker][unbound-docker]
- [https://pi-hole.net][pihole]
- [https://nlnetlabs.nl/projects/unbound/about/][unbound]
[synology-ports]: http://tonylawrence.com/posts/unix/synology/free-your-synology-ports/
[unbound-docker]: https://github.com/MatthewVance/unbound-docker
[pihole]: https://pi-hole.net
[unbound]: https://nlnetlabs.nl/projects/unbound/about/