An Ansible collection containing a set of roles that automate Dnsmasq. dnsmasq_install installs Dnsmasq and configures the system to run it. dnsmasq_dhcp configures DHCP options and tags, IPv4 ranges and client IP reservations. dnsmasq_dhcp_db adds an SQLite3 DHCP lease management. dnsmasq_dns configures DNS resolver options, including upstream servers, and a hosts file. dnsmasq_web installs the dnsmasq-web REST API.

Includes the dnsmasq_install role then the others depending based on the definition of the variable(s) each require.

See roles/dnsmasq/README.md for detailed documentation.

Installs and configures Dnsmasq on the target system using apk, dnf and zypper.

See roles/dnsmasq_install/README.md for detailed documentation.

Manages DHCP configuration including dhcp-hostsdir, dhcp-hostsfile, dhcp-ignore, dhcp-range, dhcp-options, dhcp-mac, and domain settings.

It will run when dnsmasq_dhcp_interfaces is defined.

See roles/dnsmasq_dhcp/README.md for detailed documentation.

Manages the optional lease database, associated script, and configuration. Contains a shell script and SQLite3 database schema for lease management.

It will run when dnsmasq_dhcp_db is defined.

See roles/dnsmasq_dhcp_db/README.md for detailed documentation.

Manages DNS host and server configuration including interface, addn-hosts, server, and rev-server settings.

It will run when dnsmasq_dns_servers is defined.

See roles/dnsmasq_dns/README.md for detailed documentation.

Installs the dnsmasq-web REST API for managing DHCP leases and querying client data.

It will run when dnsmasq_web_binary is defined.

See roles/dnsmasq_web/README.md for detailed documentation.

For detailed configuration options, see the individual role README files.

It offers itself as the network gateway and leases the entire subnet starting at .10. It offers itself as the DNS server and forwards all queries to the system resolver.

- hosts: dnsmasq
  vars:
    dnsmasq_dhcp_interfaces: [{ device: eth0, start: 10 }]
    dnsmasq_dns_options: [bogus-priv, domain-needed]
  roles:
    - amigus.dnsmasq.dnsmasq

It offers .1 as the network gateway and leases addresses 100-200. It uses Google for DNS but offers a different (local) resolver to WiZ light bulbs.

- hosts: dnsmasq
  vars:
    dnsmasq_dhcp_client_options:
      - tag:wizbulb,option:dns-server,192.168.1.253
    dnsmasq_dhcp_hosts: |
      6c:29:90:02:04:06,192.168.1.200,wiz_020406
    dnsmasq_dhcp_interfaces: [{ device: eth0, router: 1, start: 100, end: 199 }]
    dnsmasq_dhcp_mac_tags:
      - wizbulb: [6c:29:90:*:*:*, 44:4f:8e:*:*:*]
    dnsmasq_dns_options: [bogus-priv, domain-needed, no-resolv]
    dnsmasq_dns_servers: [{address: 8.8.8.8}, {address: 4.4.4.4}]
  roles:
    - amigus.dnsmasq.dnsmasq

It uses a lease database and installs dnsmasq-web. Dnsmasq will forward th queries for the dmz.lan, or databases.lan or, 192.168.0.0/16 to 192.168.100.3. It will forward everything else to 1.1.1.1.

- hosts: dnsmasq
  vars:
    dnsmasq_dhcp_db: /var/lib/misc/dnsmasq.leases.db
    dnsmasq_dhcp_db_script: /usr/sbin/dnsmasq-leasesdb
    dnsmasq_dhcp_domain: servers.lan
    dnsmasq_dhcp_hosts_dir: /var/lib/misc/dnsmasq.hosts.d
    dnsmasq_dhcp_interfaces: [{ device: eth0, router: 1, start: 10 }]
    dnsmasq_dns_hosts: |
      192.168.1.2 dhcp.servers.lan
      192.168.1.3 dns.servers.lan
      192.168.1.4 dns2.servers.lan
    dnsmasq_dns_options: [bogus-priv, domain-needed, no-hosts, no-resolv]
    dnsmasq_dns_servers:
      - address: 1.1.1.1
      - domain: [dmz.lan, databases.lan]
        network: 192.168.0.0/16
        address: 192.168.100.3
    dnsmasq_web_binary: /usr/sbin/dnsmasq-web
  roles:
    - amigus.dnsmasq.dnsmasq