I recently a small CLI tool I wrote for a client migration to help move ISC DHCP static mappings to Kea reservations using the OPNsense config.xml, as there's currently no way to export IPv6 static mappings via web interface.
I've open sourced it on github (should have releases for Linux, Windows, Mac).
It supports both IPv4 and IPv6 static mappings (including DUID, hostname, domain search, description). I originally wrote it mainly to handle DHCPv6 static reservations, since there isn't currently a GUI export/import path for those.
It's safe by default (reads the input config and writes to a new output file so you can review before importing) and only migrates static reservations, not pools or options.
This is very much a v1 community tool, so please test (pref in a lab) first and take a backup/snapshot before importing. If anyone wants to try it and provide feedback or edge cases, I'd really appreciate it.
See the Github README for command line usage.
- Leave kea disabled for now
- Create the relevant IPv4 and IPv6 subnets in kea
- Download the config (from system settings in GUI)
- Use scan option first to see what will change
- Use the convert option to create a new xml config
- Restore the new config from OPNsense gui
- Check the kea settings everything imported
- Disable isc and enable kea
Tested with 25.7.11:
ISC-DHCP to Kea Migration Tool (https://github.com/sheridans/isc2kea)
This is nice to have, but it's not really needed since you can Import/Export all Static DHCP Mappings by using the .csv files Import/Export option in the OPNsense webGUI ;)
Quote from: Sheridan Computers on January 23, 2026, 08:45:39 PMNot for IPv6, IPv4 only.
True, but if you leave DNS on IPv4 level there is no need to track your clients based on their IPv6 address and just use the IPv4 bindings for nice hostnames with your local domain included :)
At least I am guessing that's what you need the Static DHCPv6 Mappings for ?
Since Sam mentioned it we've made the GUI consistent https://github.com/opnsense/plugins/commit/14a130188
But more tools are certainly nice :)
Thanks,
Franco
Quote from: franco on January 24, 2026, 11:15:44 AMSince Sam mentioned it we've made the GUI consistent https://github.com/opnsense/plugins/commit/14a130188
But more tools are certainly nice :)
Thanks,
Franco
It was a good learning experience at least 😀