Ansible Role: avahi_daemon

This Ansible role installs the avahi_daemon and can automatically announce services for you.

Variables

You can set up the services you want to share using the avahi_daemon__services variable. Here's what you can include:

• service: Name of the service (like HTTP, SSH, etc.) (required)
• port: The port the service runs on (required)
• name: An optional name for the service
• protocol: Can be any, ipv6, or ipv4
• txt_records: An array of text records for additional information
• transport: Protocol type, either tcp or udp

Example Configuration:

---
avahi_daemon__services:
  - service: 'SSH'
    port: 22
    protocol: 'any'
    transport: 'tcp'
  - service: 'NFS'
    name: 'Filesharing Host %h'
    port: 2049
    protocol: 'ipv6'
    txt_records:
      - 'path=/path/to/nfsexport'
  - service: 'FTP'
    port: '21'
    protocol: 'ipv4'
    txt_records:
      - 'path=/ftppath'
      - 'u=ftpuser'
      - 'p=ftppass'

Netfilter Rules

The Avahi daemon uses multicast to broadcast services. Make sure to set up netfilter rules for multicast DNS.

Example for ferm:

# mdns
daddr 224.0.0.251 proto udp dport 5353 ACCEPT;
daddr ff02::fb proto udp dport 5353 ACCEPT;

Ansible Collection

This role belongs to the l3d.avahi Ansible Collection.

Additional Links:

• l3d.avahi Collection
• Collection Maintenance
• License Information

For more details on downloading or integrating this collection into your playbook, check the README.md.

Useful Links

• DNS-SD
• Multicast DNS
• RFC 6762
• Service Types
• Avahi Homepage
• Avahi GitHub Repository
• Avahi DTD
• NSS MDNS GitHub Repository