From 02f472dbf43f0eb759a1c7342c1cfd352d1cbf97 Mon Sep 17 00:00:00 2001 From: Ted Hyde <7480500+MrSuttonmann@users.noreply.github.com> Date: Fri, 19 Jan 2024 12:00:31 +0000 Subject: [PATCH 1/3] Create opnsense.md Signed-off-by: Ted Hyde <7480500+MrSuttonmann@users.noreply.github.com> --- docs/routers/opnsense.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 docs/routers/opnsense.md diff --git a/docs/routers/opnsense.md b/docs/routers/opnsense.md new file mode 100644 index 000000000..6cdb70eb2 --- /dev/null +++ b/docs/routers/opnsense.md @@ -0,0 +1,26 @@ +This guide was developed using OPNsense 23.7.12, but should work for others too. + +!!! note There is no single way to do it right. Choose the one best fitting your needs. + +### Using PiHole as a global DNS server + +This sets up PiHole as your global DNS server. Unless manually configured otherwise, all devices on your network will use PiHole as their DNS server. + +1. In PiHole, navigate to `Settings -> DNS` and ensure you have at least one external upstream DNS server enabled. + + **Do not use your OPNsense IP address as this will cause a circular dependancy.** + +2. In OPNsense navigate to `Settings -> General -> Networking`. +3. Under DNS Servers, enter the IPv4 address of your PiHole server, and set the gateway to your WAN interface. +4. Uncheck `Allow DNS server list to the overridden by DHCP/PPP on WAN`. +5. Click Save. + +### Using PiHole as a DNS server for a single interface + +You can set up custom DNS servers to use per local interface. For instance, you might want to use PiHole on your LAN, but not on your Guest Wifi network. + +1. In PiHole, navigate to `Settings -> DNS`. You should either have at least one external DNS server configured, or have your OPNsense IP address set as an external DNS server. +2. In OPNsense, navigate to `Services -> DHCPv4 -> []` +3. Under DNS servers, remove any other IP addresses and add your PiHole server's IP address to the list. +4. Click Save +5. You will also need to ensure that clients connected to that interface can communicate with PiHole by adding a relevant firewall entry. From 2cc4a3e97e145b5f39e264c7da236093fac109c0 Mon Sep 17 00:00:00 2001 From: Ted Hyde <7480500+MrSuttonmann@users.noreply.github.com> Date: Fri, 19 Jan 2024 12:02:59 +0000 Subject: [PATCH 2/3] Update mkdocs.yml Add nav link Signed-off-by: Ted Hyde <7480500+MrSuttonmann@users.noreply.github.com> --- mkdocs.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/mkdocs.yml b/mkdocs.yml index 5bb55224d..5c991b4d4 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -192,6 +192,7 @@ nav: - 'Fritz!Box (EN)': routers/fritzbox.md - 'Fritz!Box (DE)': routers/fritzbox-de.md - 'Nokia G-240W-B': routers/nokia-G240WB.md + - 'OPNsense': routers/opnsense.md - 'TP-Link': routers/tp-link.md - 'Ubiquiti USG': routers/ubiquiti-usg.md - 'FAQ': main/faq.md From 552c8b5654191b3228436eab3968ce56d5615218 Mon Sep 17 00:00:00 2001 From: Ted Hyde <7480500+MrSuttonmann@users.noreply.github.com> Date: Fri, 19 Jan 2024 12:06:33 +0000 Subject: [PATCH 3/3] Update opnsense.md Fix typo Signed-off-by: Ted Hyde <7480500+MrSuttonmann@users.noreply.github.com> --- docs/routers/opnsense.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/routers/opnsense.md b/docs/routers/opnsense.md index 6cdb70eb2..b71b83486 100644 --- a/docs/routers/opnsense.md +++ b/docs/routers/opnsense.md @@ -8,7 +8,7 @@ This sets up PiHole as your global DNS server. Unless manually configured otherw 1. In PiHole, navigate to `Settings -> DNS` and ensure you have at least one external upstream DNS server enabled. - **Do not use your OPNsense IP address as this will cause a circular dependancy.** + **Do not use your OPNsense IP address as this will cause a circular dependency.** 2. In OPNsense navigate to `Settings -> General -> Networking`. 3. Under DNS Servers, enter the IPv4 address of your PiHole server, and set the gateway to your WAN interface.