This page offers a simple DHCP leases search engine. It utilizes Kea control channel to find leases by an IP address, delegated prefix, client identifier, DHCPv6 DUID, or hostname. Type one of these parameters in the search box and press Enter. 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 lease_cmds hooks library. The Kea servers not running this hooks library are excluded from the search.

Search leases:

Use the input box to specify a searched lease. You can search the lease by one of the following lease properties:

  • IP address
  • delegated prefix (excluding prefix length)
  • MAC address
  • DHCPv4 client identifier
  • DHCPv6 DUID
  • hostname

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 match exactly one of the lease properties. Searching for leases using partial value, e.g. 192.0., is currently not supported.

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

The search engine will look for the specified lease on all monitored Kea servers having the lease_cmds hooks library loaded. It may return multiple leases for the same IP address or delegated prefix when Kea servers are configured to share the lease information via High Availability hooks library or shared lease database.

{{ 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 comprise all leases matching the query because some matching leases may reside on the servers, which 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: {{ lease.hwAddress }}
Client Identifier: {{ lease.clientId }}
DUID: {{ lease.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 DHCP leases on the Kea servers by IP address, delegated prefix, client identifier, DHCPv6 DUID or hostname. Click help button for details. Found {{ leases.length }} lease{{ leases.length > 1 ? 's' : '' }} matching {{ lastSearchText.trim() }}.