Ansible role coturn

Setup a TURN/STUN server using Coturn.

This role is tested using Molecule. The default will use Docker that you must install yourself. Then run tox to setup python environment and start testing. If docker can't do, a Vagrant & libvirt (tested with KVM) is also possible, set up those then tox -- test -s vagrant.

A Vagrantfile is also provided for development purpose. Install Vagrant and VirtualBox (or libvirt / KVM), then run vagrant up.

Requirements

Python & tox. See imports in library/* and tasks in molecule/default/converge.yml if any specific, but those should be added in tox.ini.

Role Variables

See defaults/main.yml.

Dependencies

See meta/main.yml and molecule/default/requirements.yml if any.

Example Playbook

- hosts: all
  vars:
    coturn_user: root
    coturn_group: root
    coturn_auth_mechanism: long-term
    coturn_users:
      - username: turnuser
        password: turnpwd
    coturn_realm: turnrealm
    coturn_alternative_listening_port: 80
    coturn_tls_enabled: false
    coturn_dtls_enabled: false
    coturn_tls_alternative_listening_port: 443
    coturn_web_admin_enabled: false
    coturn_web_admin_ip: 0.0.0.0
  roles:
    - wazo.coturn

License

MIT

Author Information

Wazo Developers for Wazo https://wazo.io