kea/platforms.rst

.. _platforms:

Supported Platforms
===================

In general, this version of Kea builds and runs on any POSIX-compliant
system with a C++ compiler (with C++14 support), the Botan cryptographic library,
the log4cplus logging library and the Boost system library.

ISC regularly tests Kea on many operating systems and architectures, but
lacks the resources to test all of them. Consequently, ISC is only able to
offer support on a "best-effort" basis for some.

Regularly Tested Platforms
--------------------------

Kea is officially supported on Alpine, Debian, Fedora, FreeBSD, RHEL, and Ubuntu
systems. Kea-|release| builds have been tested on:

* Alpine — 3.16, 3.17, 3.18, 3.19
* Debian — 10, 11, 12
* Fedora — 36, 37, 38, 39
* FreeBSD — 13
* RHEL — 8, 9
* Ubuntu — 18.04, 20.04, 22.04

There are currently no plans to port Kea to Windows systems.

Best-Effort
-----------

The following are platforms on which Kea is known to build and run.
ISC makes every effort to fix bugs on these platforms, but may be unable to
do so quickly due to lack of hardware, less familiarity on the part of
engineering staff, and other constraints.

* macOS — 11, 12, 13

Community-Maintained
--------------------

These systems have once been regularly tested, but official support for it has
been abandoned, usually due to discontinued support on their own part. Older
versions may not have the required dependencies for building Kea easily
available, although it is possible in many cases to compile on those directly
from source. The community and interested parties may wish to help with
maintenance, and we welcome patch contributions, although we cannot guarantee
that we will accept them. All contributions are assessed against the risk of
adverse effect on officially supported platforms.

These include platforms past their respective EOL dates, such as:

* Alpine — 3.10, 3.11, 3.12, 3.13, 3.14, 3.15 (EOL 01 Nov 2023)
* CentOS — 6 (EOL 30 November 2020), 7 (EOL 30 June 2024), 8 (EOL 31 December 2021)
* Debian — 8, 9 (EOL 30 June 2022)
* Fedora — 31, 32, 33, 34, 35 (EOL 13 December 2022)
* FreeBSD — 10, 11, 12
* macOS — 10.13, 10.14, 10.15 (EOL 12 September 2022)
* Ubuntu — 14.04, 18.10, 19.04, 19.10, 21.04 (EOL 20 January 2022)

Unsupported Platforms
---------------------

These are platforms on which versions of Kea since 1.7 are known *not* to build or run:

* Windows (all versions)
* Windows Server (all versions)
* Any platform with OpenSSL 1.0.1 or earlier, which does not also have Botan as an alternative
* Any platform with log4cplus version 1.0.2 or earlier.
* Any platform with a compiler that doesn't support C++14.

.. _required-software:

Required Software at Runtime
============================

Kea uses various extra software packages which may not be
provided in the default installation of some operating systems, nor in
the standard package collections. This required software may need to
be installed separately. (For the build requirements, also see :ref:`build-requirements`.)

-  Kea supports two cryptographic libraries: Botan and OpenSSL. Only one
   of them is required to be installed during compilation. Kea uses the
   Botan library for C++ (https://botan.randombit.net/), version 2.0 or
   later; support for Botan versions earlier than 2.0 was
   removed as of Kea 1.7.0. As an alternative to Botan, Kea can
   use the OpenSSL cryptographic library (https://www.openssl.org/),
   version 1.0.2 or later.

-  Kea uses the log4cplus C++ logging library
   (https://sourceforge.net/p/log4cplus/wiki/Home/). It requires log4cplus version
   1.0.3 or later.

-  Kea requires the Boost system library (https://www.boost.org/).
   Building with the header-only version of Boost is no longer
   recommended.

Some optional features of Kea have additional dependencies.

-  To store lease information in a MySQL database, Kea requires
   MySQL headers and libraries. This is an optional dependency;
   Kea can be built without MySQL support.

-  To store lease information in a PostgreSQL database, Kea
   requires PostgreSQL headers and libraries. This is an optional
   dependency; Kea can be built without PostgreSQL support.

-  Kea provides a NETCONF interface with the ``kea-netconf`` agent. This Kea module
   requires Sysrepo software when used. Building Kea with NETCONF support
   requires many dependencies to be installed, which are described in more
   detail in :ref:`netconf-install`. This is an optional dependency; Kea can be
   built without NETCONF support.

-  To sign and verify DNS updates the Kea DDNS server may use GSS-TSIG, which requires
   MIT Kerberos 5 or Heimdal libraries. The dependencies required to be
   installed are described in more detail in :ref:`gss-tsig-install`. This is an
   optional dependency; Kea can be built without GSS-TSIG support.