Skip to content

Setup & installation

A single TOML file (config/lighthouse.example.toml). Hot-reloads on change / SIGHUP and is validated before apply. Sections include [server], [logging], [lease], [control_api], [[subnet]] (+ [[subnet.reservation]], [[subnet.boot]]), [[client_class]], [ddns], [dhcpv6], [ha].

  • DHCPv4 (RFC 2131/2132) + DHCPv6 (RFC 8415, IA_NA + prefix delegation).
  • Reservations — MAC or client-id → IP + hostname.
  • Client classification — vendor/user class, MAC OUI, class-restricted pools.
  • Dynamic DNS — RFC 2136 + TSIG via lighthouse-ddnsd.
  • PXE — arch-aware boot directives + bundled read-only TFTP.
  • PostgreSQL lease backend + HA (shared-DB active-active).

Local accounts (argon2, forced first-run password change) or AD/LDAP sign-in. LDAP is configured via environment variables (LH_MGMT_LDAP_*). RBAC: admin / operator / viewer.