ripnet/clab-kea-dhcp

A containerized ISC Kea DHCPv4/v6 server specifically tailored for containerlab environments.

Why use this image

Unlike standard DHCP containers, this image is built to handle the unique quirks of containerlab:

• Uses eth1 - Binds and routes traffic via the eth1 data-plane interface
• Relay Ready - Configures DHCPv6 to listen on Global Unicast Addresses (GUA) to correctly handle relayed traffic from access routers.

Usage in containerlab

The environment variables do not need to be specified. These below are the defaults.

topology:
  nodes:
    dhcp-server:
      kind: linux
      image: ghcr.io/ripnet/clab-kea-dhcp:latest
      env:
        # Server Connectivity Defaults:
        ETH1_V4: 198.51.100.2/24
        ETH1_V6: 2001:db8:ffff::2/64
        SERVER_GW_V4: 198.51.100.1
        SERVER_GW_V6: 2001:db8:0::1

        # v4 Customer Pool Defaults
        V4_SUBNET: 192.0.2.0/24
        V4_POOL_START: 192.0.2.10
        V4_POOL_END: 192.0.2.250
        V4_POOL_GW: 192.0.2.1

        # v6 IA_NA
        V6_NA_SUBNET: 2001:db8:0::/64
        V6_NA_POOL_START: 2001:db8:0::1000
        V6_NA_POOL_END: 2001:db8:0::2000

        # v6 IA_PD
        V6_PD_POOL_BASE: 2001:db8:cafe::"
        V6_PD_POOL_LEN: 48
        V6_PD_DELEGATED_LEN: 56
  links:
    - endpoints: ["dhcp-server:eth1", "router:eth1"]