OPNsense Forum

English Forums => 25.1, 25.4 Series => Topic started by: bigmacro on April 06, 2025, 09:50:50 PM

Title: Current 25.1 DHCP documentation is for 25.7 DNSMasq DHCP
Post by: bigmacro on April 06, 2025, 09:50:50 PM
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?
Title: Re: Current 25.1 DHCP documentation is for 25.7 DNSMasq DHCP
Post by: passeri on April 06, 2025, 11:59:23 PM
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.
Title: Re: Current 25.1 DHCP documentation is for 25.7 DNSMasq DHCP
Post by: Monviech (Cedrik) on April 07, 2025, 07:25:45 AM
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
Title: Re: Current 25.1 DHCP documentation is for 25.7 DNSMasq DHCP
Post by: franco on April 08, 2025, 08:58:59 AM
> 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
Title: Re: Current 25.1 DHCP documentation is for 25.7 DNSMasq DHCP
Post by: Zenuncl on April 20, 2025, 02:04:55 AM
> 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!"
Title: Re: Current 25.1 DHCP documentation is for 25.7 DNSMasq DHCP
Post by: newsense on April 20, 2025, 02:21:27 AM
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
Title: Re: Current 25.1 DHCP documentation is for 25.7 DNSMasq DHCP
Post by: bigmacro on April 20, 2025, 02:24:19 AM
That's good to hear. I'd like to implement the new system, so I'll wait for it.
Title: Re: Current 25.1 DHCP documentation is for 25.7 DNSMasq DHCP
Post by: newsense on April 20, 2025, 02:35:55 AM
This thread may be of interest

https://forum.opnsense.org/index.php?topic=46856.0 (https://forum.opnsense.org/index.php?topic=46856.0)
Title: Re: Current 25.1 DHCP documentation is for 25.7 DNSMasq DHCP
Post by: gspannu on April 30, 2025, 12:20:26 PM
Quote from: newsense on April 20, 2025, 02:21:27 AMUntil 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...
Title: Re: Current 25.1 DHCP documentation is for 25.7 DNSMasq DHCP
Post by: franco on April 30, 2025, 12:21:44 PM
Wait for 25.1.6 next week or use the development version which is very easy to install.


Cheers,
Franco
Title: Re: Current 25.1 DHCP documentation is for 25.7 DNSMasq DHCP
Post by: gspannu on April 30, 2025, 02:12:57 PM
Quote from: franco on April 30, 2025, 12:21:44 PMWait for 25.1.6 next week or use the development version which is very easy to install.


Cheers,
Franco

Awesome... thanks for the update.