Kea 1.0.0, December 29 2015, Release Notes

Welcome to the 1.0.0 release of Kea. Kea is an alternative DHCP implementation being developed by Internet Systems Consortium, Inc. that features fully functional DHCPv4, DHCPv6 servers, Dynamic DNS updates daemon and a DHCP performance measurement tool. Both DHCP servers fully support server discovery, address assignment, renewal, rebinding, release, decline, information request, DNS updates and host reservation. The DHCPv6 server supports prefix delegation. Lease information can be stored in CSV files, MySQL or PostgreSQL databases.

Version 1.0.0 adds the following features to Kea:

  • Lease expiration. A configurable mechanism which provides the ability to properly clean up expired leases including hook points, DNS clean up, and logging.
  • Client classification. Initial support for client classification using conditional logic expressions to test inbound packet content is available for both DHCPv4 and DHCPv6.
  • Decline support in both DHCPv4 and DHCPv6.
  • New statistics. Several new statistics have been added. They can be used to monitor lease expiration and decline processing.
  • PXE boot. Several new DHCPv4 and DHCPv6 options useful for PXE and iPXE boot are now supported.
  • Host Reservations in MySQL. Kea is now able to store host reservations in both its configuration file and a MySQL database. While currently available only for DHCPv4, this functionality will be available for DHCPv6 in an upcoming release.

Important license change: Kea 1.0.0 is released under new license Mozilla Public License 2.0. Earlier releases were licensed under the ISC license. The new license is slightly more restrictive than the original ISC license. If you are planning to redistribute Kea, please review the terms of the new license. For more details about why we are making this change, see the blog posting:

The MPL 2.0 license: An excellent FAQ about the MPL2.0:


The kea-1.0.0 source may be downloaded from:

A PGP signature of the distribution is at

The signature was generated with the ISC code signing key which is available at

ISC provides detailed documentation, including installation instructions and usage tutorials in the Kea Administrator Reference Manual. Documentation is included with the installation or via in HTML, plain text, or PDF formats. ISC maintains a public open source code tree at and wiki pages with roadmap and issue tracking at

Limitations and known issues with this DHCP release can be found at

We'd like users of this software to please let us know how it worked for you and what operating system you tested on. Feel free to share your configuration or use case. Also we would like to hear whether the documentation is adequate and accurate (please open tickets for documentation omissions and errors). We want to hear from you even if everything worked.


Professional support for Kea is available from ISC. Free best-effort support is provided by our user community via a mailing list. Information on all public email lists is available at

If you have any comments or questions about working with Kea, please share them to the Kea Users List or to the Kea Jabber room. Bugs and feature requests may be submitted via the ticket tracking system at


The following summarizes changes and important upgrade notes since the previous release (1.0.0-beta2). (See the git history for more details and additional development.)

  1. [bug] jpopelka

Fixed compilation issue in MySQL host data source: the dhcp_identifier_length is now unsigned long. This addresses a compilation problem on Fedora. (Github #17, git 8548d1b589df98cc956b4d80d2cb8819ef576717)

  1. [bug] fdupont

Removed warnings emitted during generation of Doxygen documentation. (Trac #4234, git b67910a3893bc79eb77a48bae6c31214a317bd40)

  1. [bug] marcin

Addressed regression in distcheck after merge of #4224. Before the changes one of the lease files produced by 'kea-lfc' was not removed after tests running lease file cleanup. As a result, the distcheck failed discovering this file being left after distclean. (Trac #4249, git 04aa9b95bf8c4dd8b555dd78cc8cd57126473800)

  1. [bug] tmark

This change bumps the MySQL schema version from 4.0 to 4.1 and includes the following changes: added explicit use of InnoDB engine to all MySQL table create statements, MySQL lease dump output is now sorted by lease address in ascending order, and the MySQL lease_hwaddr_source table now contains an entry for HWADDR_SOURCE_UNKNOWN (i.e. source = 0). Our thanks to Sebastien Couture at Ubity Inc. for reporting the InnoDB engine issue and submitting a fix for it. (Github #16, Trac #4237,#4238, git f0fb9f35a394785215573a591c2bcc68ab481436)

  1. [doc] marcin

Changed Kea license from ISC to Mozilla Public License,

  1. 2.0. (Trac #4236, git a0574cdab4deb31e3244fc4e237753a1ad361d96)
  1. [bug] marcin

PID files created by Kea processes are used in shell based tests to determine if the given process is running. This solves the problem whereby some unrelated processes could be reported as running Kea processes in those tests, causing the tests to fail. (Trac #4224, git 94edccc50cb374ec4db35f653b869c9f06d356ea)

  1. [doc] tomek

Developer's Guide updated with client classification text and several clean-ups. (Trac #4102, git ac33ebf7428ba5935d3302d000bed317716fabfe)

  1. [bug] tmark

The lease6 hardware address source value is now being properly populated. Prior to this the value stored with each IPv6 lease was always zero. (Trac #4247, git 27886dadcf9051dc622ee6fde586c27f3d431f8b)

  1. [func] tmark

Assigned unique log message IDs to log messages issued from MySQL hosts storage operations, eliminating reuse of lease database message IDs. (Trac #4216, git f0e37cd6d45537971a730c68187011dce41217cc)

  1. [doc] sar

Correct v6 classification examples to use client-id (1) instead of server-id (2). (Trac #4222, git 69dd98d03861d9de72c2ef75c17c8154b0c5088b)

Thank you again to everyone who assisted us in making this release possible. If you would like to contribute to ISC to assist us in continuing to make quality open source software, please visit our donations page at

We look forward to receiving your feedback.

Last modified 4 years ago Last modified on Dec 29, 2015, 6:00:02 PM