From d56fb7f939824f5757795d85e89838108df00734 Mon Sep 17 00:00:00 2001 From: Ying Date: Thu, 24 Dec 2020 14:24:32 -0800 Subject: [PATCH] Minor updates to Pi-hole README.md (#82) * Add a few extra steps * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md --- run-pihole/README.md | 32 ++++++++++++++++++++++++++------ 1 file changed, 26 insertions(+), 6 deletions(-) diff --git a/run-pihole/README.md b/run-pihole/README.md index e54d159..9edb6aa 100644 --- a/run-pihole/README.md +++ b/run-pihole/README.md @@ -1,8 +1,8 @@ -# Run PiHole on your UDM +# Run Pi-hole on your UDM ## Features -1. Run PiHole on your UDM with a completely isolated network stack. This will not port conflict or be influenced by any changes on by Ubiquiti +1. Run Pi-hole on your UDM with a completely isolated network stack. This will not port conflict or be influenced by any changes on by Ubiquiti 2. Persists through reboots and firmware updates. ## Requirements @@ -20,8 +20,26 @@ 1. On your controller, make a Corporate network with no DHCP server and give it a VLAN. For this example we are using VLAN 5. 2. Copy [20-dns.conflist](../cni-plugins/20-dns.conflist) to /mnt/data/podman/cni. This will create your podman macvlan network 3. Copy [10-dns.sh](../dns-common/on_boot.d/10-dns.sh) to /mnt/data/on_boot.d and update its values to reflect your environment + + ``` + ... + VLAN=5 + IPV4_IP="10.0.5.3" + IPV4_GW="10.0.5.1/24" + ... + CONTAINER=pihole + ... + ``` + 4. Execute /mnt/data/on_boot.d/10-dns.sh -5. Run the pihole docker container, be sure to make the directories for your persistent pihole configuration. They are mounted as volumes in the command below. +5. Create directories for persistent Pi-hole configuration + + ``` + mkdir -p /mnt/data/etc-pihole + mkdir -p /mnt/data/pihole/etc-dnsmasq.d + ``` + +6. Create and run the Pi-hole docker container. The following command sets the upstream DNS servers to 1.1.1.1 and 8.8.8.8. ```sh podman run -d --network dns --restart always \ @@ -29,7 +47,9 @@ -e TZ="America/Los Angeles" \ -v "/mnt/data/etc-pihole/:/etc/pihole/" \ -v "/mnt/data/pihole/etc-dnsmasq.d/:/etc/dnsmasq.d/" \ - --dns=127.0.0.1 --dns=1.1.1.1 \ + --dns=127.0.0.1 \ + --dns=1.1.1.1 \ + --dns=8.8.8.8 \ --hostname pi.hole \ -e VIRTUAL_HOST="pi.hole" \ -e PROXY_LOCATION="pi.hole" \ @@ -51,5 +71,5 @@ podman exec -it pihole pihole -a -p YOURNEWPASSHERE ``` -7. Update your DNS Servers to 10.0.5.3 (or your custom ip) in all your DHCP configs. -8. Access the pihole like you would normally. +7. Update your DNS Servers to 10.0.5.3 (or your custom ip) for each of your Networks (UDM GUI | Networks | Advanced | DHCP Name Server) +8. Access the pihole like you would normally, e.g. http://10.0.5.3 if using examples above