{# SPDX-FileCopyrightText: 2025 Marcin Zieba #} {# SPDX-License-Identifier: Apache-2.0 #} {% extends "generic/object.html" %} {% load helpers %} {% block content %}
{% if not plugin_available %} {% else %}
Sync to DHCP plugin

Import this server's live Kea configuration into the NetBox DHCP plugin. This includes subnets, pools, reservations, supported settings, client classes, and DHCP options. The import reads Kea without changing it. You can run the import more than once.

Import mapping notes
1 Shared Network grouping

Kea shared-networks define a DHCP link and subnet-selection domain. They do not map to the DHCP plugin's Shared Networks. The DHCP plugin's Shared Networks require an aggregate Prefix. Member Subnets are imported individually and remain attached directly to the DHCP Server.

2 Direct-interface mapping

A direct-interface selector has a partial representation. When it resolves to a NetBox device or virtual-machine interface, DHCPServerInterface can represent that server attachment. It does not preserve Shared Network identity, membership, relay selection, inherited settings or options, or allocation behavior. NetBox Kea remains the authority for those facts.

3 DHCP option mapping

DHCP options are imported at supported scopes when the import can resolve a matching standard or custom Option Definition. Unsupported options are skipped and reported.

{% if can_sync %}
{% csrf_token %}
{% else %} You need server change + IPAM add/change permissions to run this. {% endif %}
Drift — live Kea vs. imported records
{% if drift.kea_unreachable %} {% endif %} {% if drift.versions %}
{% for v in drift.versions %} {% for row in v.rows %} {% empty %} {% endfor %} {% endfor %}
Kea subnet-id Prefix Status Pools Reservations
DHCPv{{ v.version }}
{{ row.kea_subnet_id|placeholder }} {{ row.cidr|placeholder }} {% if row.status == "imported" %} Imported {% elif row.status == "new" %} New in Kea {% elif row.status == "orphaned" %} Orphaned (gone from Kea) {% else %} Unknown {% endif %} {{ row.pools }} {{ row.reservations }}
No subnets.
{% else %}

No DHCP versions enabled on this server.

{% endif %}
{% endif %}
{% endblock %}