Skip to content

Commit 3b80ed5

Browse files
authored
dnsmasq: Specify default DHCP options better (opnsense#732)
1 parent 08b1388 commit 3b80ed5

File tree

1 file changed

+18
-6
lines changed

1 file changed

+18
-6
lines changed

source/manual/dnsmasq.rst

Lines changed: 18 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -511,17 +511,29 @@ As next step we define the DHCP ranges for our interfaces.
511511

512512
- Press **Save** and **Apply**
513513

514+
514515
.. Tip::
515516

516-
**There is no need to create DHCP options manually for simple setups**.
517+
Creating a DHCP range will automatically send out common DHCP options to requesting clients, without explicitely configuring them.
518+
519+
This is an incomplete overview which highlights some default DHCP options:
517520

518-
Creating a DHCP range will set these DHCP options automatically with defaults:
521+
================================================== ====================================================== ===================================================
522+
DHCP Option Default Description
523+
================================================== ====================================================== ===================================================
524+
router[3] IPv4 address of the interface that received the The default gateway the client should use.
525+
DHCP Request. In this case the OPNsense.
526+
dns-server[6] IPv4 address of the interface that received the The DNS server the client should use.
527+
DHCP Request. In this case Unbound on the OPNsense.
528+
domain-name[15] Domain set in a DHCP Range, or the default The domain name the client should use,
529+
system domain if none could be matched. to construct short names to FQDNs in DNS lookups
530+
client fqdn[81] A combination of client hostname and domain, the The full qualified domain name the client should
531+
result of the DDNS registration. use.
532+
================================================== ====================================================== ===================================================
519533

520-
- ``router[3]`` -> IPv4 address of the receiving interface
521-
- ``dns-server[6]`` -> IPv4 address of the receiving interface
522-
- ``domain-search[119]`` -> Domain set in DHCP range
534+
.. Note::
523535

524-
There is only a need to specify these options if a different IP address should be advertised, e.g., in high availability setups with CARP.
536+
Only some usecases require setting these options manually, e.g., the IPv4 address of the router and dns-server in high availability setups with CARP.
525537

526538
.. Attention::
527539

0 commit comments

Comments
 (0)