Getting started

Default configuration

The service will be configured to serve media files from the /var/lib/minidlna directory. You might want to include additional media directories in the configuration, see minidlna__configuration variable documentation for details and examples.

MiniDLNA uses Simple Service Discovery Protocol to advertise its presence on the network. The service is advertised via the 239.255.255.250 multicast address over 1900/udp port and clients that want to use the DLNA service need to have this port opened in their firewalls to receive the advertisements.

Keep in mind that SSDP protocol might be used for DDoS reflection attacks if not properly secured; you should grant access to this port only from trusted networks.

Example inventory

To enable MiniDLNA service on a host it needs to be included in the specific Ansible inventory group:

[debops_service_minidlna]
hostname

Example playbook

If you are using this role without DebOps, here's an example Ansible playbook that uses the debops.minidlna role:

---

- name: Install and manage MiniDLNA
  collections: [ 'debops.debops', 'debops.roles01',
                 'debops.roles02', 'debops.roles03' ]
  hosts: [ 'debops_service_minidlna' ]
  become: True

  environment: '{{ inventory__environment | d({})
                   | combine(inventory__group_environment | d({}))
                   | combine(inventory__host_environment  | d({})) }}'

  roles:

    - role: etc_services
      tags: [ 'role::etc_services', 'skip::etc_services' ]
      etc_services__dependent_list:
        - '{{ minidlna_server__etc_services__dependent_list }}'

    - role: ferm
      tags: [ 'role::ferm', 'skip::ferm' ]
      ferm__dependent_rules:
        - '{{ minidlna__ferm__dependent_rules }}'

    - role: minidlna
      tags: [ 'role::minidlna', 'skip::minidlna' ]