Current 25.1 DHCP documentation is for 25.7 DNSMasq DHCP

[bigmacro]

I'm setting up a new OPNsense 25.1.4 VM, and following the documentation at:

https://docs.opnsense.org/manual/dhcp.html
and
https://docs.opnsense.org/manual/dnsmasq.html

However, I have no come to realize these guides are written for unreleased version 25.7, and they do not match my web GUI configuration options at all. They are talking about using DNSMasq for DHCP and local DNS as a forwarded zone from Unbound DNS. It sounds like a good idea to me, but not fully baked yet?

Where'd the documentation for the current release go? What's the current suggested DHCP/DNS implementation for SOHO/Homelab with some local servers, custom domain name, and IPV4 & IPV6?

[passeri]

I have read some discussion here that not everyone thinks it is a great idea. If there were competition for resources then my vote would be for work on Kea which supersedes ISC DHCP, is easy to use, but does not yet cover some ISC DHCP features in its current implementation. I guess the question is around ease of managing DNS, not relevant for me given I already use BIND and Unbound in a split brain config.

[Monviech (Cedrik)]

Right now the dnsmasq man page indeed references the current state of the development branch, as the documentation has no version selection.

Though as the component will be released soon, I expect probably 25.1.6, it will be the correct version again soon.

For now you can go back in the git timeline as workaround:

https://github.com/opnsense/docs/blob/dc87727733d3eaba451b5ce3a3b07fc58d6a9b31/source/manual/dnsmasq.rst

[franco]

> I have read some discussion here that not everyone thinks it is a great idea.

There is no single "great idea" in the DHCP scope at the moment. The three options are ISC DHCP, Kea DHCP or Dnsmasq.  If you take ISC DHCP out for its obvious deprecation then Dnsmasq will fill the gap where Kea is just overblown. Kea DHCPv6 will follow next year and ISC DHCP will go away to plugins at that particular moment in time. In the meantime Dnsmasq DHCPv4/6 will be there for small and medium deployments.


Cheers,
Franco

[Zenuncl]

> I expect probably 25.1.6, it will be the correct version again soon.

https://docs.opnsense.org/manual/dhcp.html
This document indicated that it will be available on version 25.7, given current version is 25.1.5, is that mean we still need to wait for few months? Or if it's a typo on that document?

The latest release note also mentioned that "Also brace for impact as we crash-land Dnsmasq DHCP support in a stable release within the next 90 days!"

[newsense]

Until hearing otherwise and should there be no critical issues discovered last minute I would still expect it Wednesday-Thursday next week in 25.1.6

[bigmacro]

That's good to hear. I'd like to implement the new system, so I'll wait for it.

[newsense]

This thread may be of interest

https://forum.opnsense.org/index.php?topic=46856.0

[gspannu]

Until hearing otherwise and should there be no critical issues discovered last minute I would still expect it Wednesday-Thursday next week in 25.1.6

Any news...
I too am keenly looking forward for the `dnsmasq dhcp` features to drop, so that I could start setting up everything. I know dnsmasq-dhcp is available in the dev build, but wanted to avoid going that route...

[franco]

Wait for 25.1.6 next week or use the development version which is very easy to install.


Cheers,
Franco

[gspannu]

Wait for 25.1.6 next week or use the development version which is very easy to install.


Cheers,
Franco

Awesome... thanks for the update.