Ansible Role: dhcpd

Installs and configure a dhcp server on varoius linux systems.

Requirements & Dependencies

Ansible Collections

• bodsch.core

ansible-galaxy collection install bodsch.core

or

ansible-galaxy collection install --requirements-file collections.yml

tested operating systems

• ArchLinux
• Debian based
  • Debian 10 / 11 / 12
  • Ubuntu 20.04 / 22.04

RedHat-based systems are no longer officially supported! May work, but does not have to.

usage

dhcpd_server_global:
  authoritative: false
  # Default lease time for all IP address leases (18 hours)
  default_lease_time: '{{ (((dhcpd_lease_time | int / 2) + 6) * 60 * 60) | round | int }}'
  # Maximum lease time for all IP addresses (24 hours)
  max_lease_time: '{{ (dhcpd_lease_time | int * 60 * 60) | round | int }}'
  # Log facility to use
  log_facility: 'local7'
  options:
    domain_name: "{{ ansible_domain }}"
    routers: []

dhcpd_ddns:
  update_style: standard

dhcpd_subnets: {}

dhcpd_groups: {}

dhcpd_hosts: {}

dhcpd_interfaces: {}

dhcpd_auto_options: false

examples

dhcpd_server_global:
  authoritative: false
  default_lease_time: 600
  max_lease_time: 7200
  options:
    domain_name: "molecule.test"
    domain_search: "molecule.test"
    domain_name_servers:
      - 192.168.1.5
      - 141.1.1.1

dhcpd_interfaces:
  ipv4:
    - eth0
  ipv6: []

dhcpd_subnets

dhcpd_subnets:
  "LOCAL net":
    comment: 'ipv4 - generated automatically by Ansible'
    subnet: '{{ ansible_default_ipv4.network + "/" + ansible_default_ipv4.netmask }}'
    routers:
      - 192.168.1.1
    options:
      default-lease-time: 2400
      max-lease-time: 7200

dhcpd_groups

dhcpd_groups:
  infrastructure:
    comment: "infrastructure"
    options:
      domain_name: "molecule.test"
      domain_search: "molecule.test"
      domain_name_servers:
    hosts:
      nas:
        comment: "simply the NAS"
        mac: 00:08:9b:f9:yy:xx
        address: 192.168.1.6
        options:
          host_name: "nas"
          max_lease_time: 1200

dhcpd_hosts

dhcpd_hosts:
  brennstuhl:
    comment: socket with LAN
    address: 192.168.1.4
    mac: 20:4C:6D:00:yy:xx

---

Author and License

• Bodo Schulz

License

Apache

FREE SOFTWARE, HELL YEAH!