This page offers a simple search engine for DHCP leases. It uses the Kea control channel to find leases by an IP address, delegated prefix, client identifier, DHCPv6 DUID, or hostname. To search, type one of these parameters into the search box and press Enter, or to find all declined leases, type state:declined in the search box. The engine will find all matching leases on the monitored Kea servers running the lease_cmds hook library. Any Kea servers not running this hook library are excluded from the search.

Use the input box to specify a lease for searching, using one of the following lease properties:

kea-dhcp4 kea-dhcp6 {{ r.h }} {{ r.dhcp4 ? '✅' : '' }} {{ r.dhcp6 ? '✅' : '' }}

MAC address, client identifier, and DUID can be specified in the following formats:

  • 01:02:03:04:05
  • 01 02 03 04 05
  • 0102030405

The specified text must exactly match one of the lease properties. Searching for leases using partial values, e.g. 192.0., is not currently supported.

To find all declined leases, type state:declined in the search box.

The search engine looks for the specified lease on all monitored Kea servers that have the lease_cmds hook library loaded. If the Kea servers are configured to share lease information via the High Availability hook library or a shared lease database, the search may return multiple leases for the same IP address or delegated prefix.

{{ invalidSearchTextError }}
Stork attempted to find leases on the Kea servers, but some servers failed to respond or returned an error in response to the control commands. The results presented in the table below may not include all leases matching the query because some matching leases may reside on a server that returned an error. Issues were found for the following Kea servers:
Lease Type State App Name {{ lease.ipAddress + (lease.prefixLength ? '/' + lease.prefixLength : '') }} {{ leaseTypeAsText(lease.leaseType) }} {{ leaseStateAsText(lease.state) }} {{ lease.appName }}
MAC address:
Client Identifier:
DUID:
Subnet Identifier: {{ lease.subnetId }}
IAID: {{ lease.iaid }}
Preferred Lifetime: {{ lease.preferredLifetime }} seconds
Valid Lifetime: {{ lease.validLifetime }} seconds
Allocated at: {{ lease.cltt | localtime }}
Expires at: {{ lease.cltt + lease.validLifetime | localtime }}
Hostname: {{ lease.hostname }}
Forward DDNS: {{ lease.fqdnFwd ? 'yes' : 'no' }}
Reverse DDNS: {{ lease.fqdnRev ? 'yes' : 'no' }}
Searching for leases on Kea servers... No leases found matching {{ lastSearchText }}. Search for leases on the Kea DHCP servers by IP address, delegated prefix, MAC address, client identifier, DHCPv6 DUID, or hostname. Click the help button next to the search form for details. Found {{ leases.length }} lease{{ leases.length > 1 ? 's' : '' }} matching {{ lastSearchText.trim() }}.