Description

Kea DHCP Server Container Image

Kea is an open source DHCP server developed by the Internet Systems Consortium and the successor of the now deprecated DHCPd. The Kea distribution includes a DHCPv4 server, a DHCPv6 server, and a Dynamic DNS (DDNS) server. Significant features include: support for IPv6 prefix delegation, host reservations (which may be optionally stored in a separate back end database), Preboot Execution Environment (PXE) boot, client classification, shared networks, and high-availability (failover pairs). Kea can store leases locally in a memfile, or in a PostgreSQL or MySQL database. Kea has a supported API for writing optional extensions, using 'hooks'.

How to use this Container Image

The container image expects configuration file in the directory /etc/kea. Execute the following command to run DHCP using the configuration provided in the directory /etc/kea:

podman container runlabel run \
      registry.suse.com/suse/kea:3.0

To run a DHCP6 server using the configuration file supplied in the directory /etc/kea, execute the following command:

podman container runlabel run_dhcp6 \
      registry.suse.com/suse/kea:3.0

The Kea configuration file can also be provided in the current working directory. To run a DHCP or a DHCP6 server using the configuration file in the current working directory, execute the following commands:

$ # for DHCP
$ podman container runlabel runcwd \
      registry.suse.com/suse/kea:3.0
$ # for DHCP6
$ podman container runlabel runcwd_dhcp6 \
      registry.suse.com/suse/kea:3.0

Licensing

SPDX-License-Identifier: MPL-2.0

This documentation and the build recipe are licensed as MPL-2.0. The container itself contains various software components under various open source licenses listed in the associated Software Bill of Materials (SBOM).

This image is based on SUSE Linux Enterprise Server, a reliable, secure, and scalable server operating system built to power mission-critical workloads in physical and virtual environments.