ansible_role_avahi_daemon/README.md

[![Ansible Galaxy](https://ansible.l3d.space/svg/l3d.avahi_daemon.svg)](https://galaxy.ansible.com/ui/standalone/roles/l3d/avahi_daemon/)
[![MIT License](https://ansible.l3d.space/svg/l3d.avahi_daemon_license.svg)](LICENSE)
[![Maintainance](https://ansible.l3d.space/svg/l3d.avahi_daemon_maintainance.svg)](https://ansible.l3d.space/#l3d.avahi_daemon)

 ansible role avahi_daemon
===========================
Ansible role to install the avahi_daemon and optionally announce some services.

 Variables
-----------
In the ``avahi_daemon__services`` variable you can define the services you want to announce.
Here is a list with available parameters:
 + ``service``: Service Name *(HTTP/SSH/...)* ***(required)***
 + ``port``: Service Port ***(required)***
 - ``name``: optional name to announce the Service
 - ``protocol``: ``any``/``ipv6``/``ipv4``
 - ``txt_records``: an array of txt records
 - ``transport``: Transport Protokoll (``tcp``/``udp``)


Example:
```yaml
---
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
---------------
Avahi is using multicast to announce services.
Do not forget to add netfilter rules for multicast dns.

Configuration 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 is part of the ``l3d.avahi`` Ansible Collection.

[![collection l3d.avahi](https://ansible.l3d.space/svg/l3d.avahi_ansible-collection_collection.svg)](https://galaxy.ansible.com/ui/repo/published/l3d/avahi/)
[![Maintainance](https://ansible.l3d.space/svg/l3d.avahi_maintainance_collection.svg)](https://ansible.l3d.space/#l3d.avahi)
[![License](https://ansible.l3d.space/svg/l3d.avahi_license_collection.svg)](LICENSE)

Visit the [README.md](https://github.com/roles-ansible/ansible_collection_avahi#readme) of the l3d.avahi collection for information about downloading or integrating the collection to your ansible playbook.

### Role Usage Example:
```bash
Links
-----
* http://dns-sd.org/
* http://www.multicastdns.org/
* https://www.ietf.org/rfc/rfc6762.txt
* http://www.dns-sd.org/ServiceTypes.html

- https://www.avahi.org/
- https://github.com/lathiat/avahi

+ https://github.com/lathiat/avahi/blob/master/avahi-daemon/avahi-service.dtd

* https://github.com/lathiat/nss-mdns