buluma.turn
Ansible Role turn
This role installs and sets up a (co)turn server on your system.
GitHub | Version | Issues | Pull Requests | Downloads |
---|---|---|---|---|
Example Playbook
Here’s an example from molecule/default/converge.yml
that is tested on every change.
---
- name: Set Up Turn Server
hosts: all
become: true
gather_facts: true
roles:
- role: buluma.turn
turn_listening_ip: "0.0.0.0"
turn_external_ip: "1.2.3.4"
Make sure to prepare your machine first. In CI, this uses molecule/default/prepare.yml
:
---
- name: Prepare Machine
hosts: all
become: true
gather_facts: false
roles:
- role: buluma.bootstrap
- role: buluma.epel
You can find a detailed explanation and examples on using these roles.
Role Variables
Default variable values are in defaults/main.yml
:
---
# Default settings for turn
turn_listening_port: 3478
turn_fingerprint: true
turn_lt_cred_mech: false
turn_use_auth_secret: true
turn_static_auth_secret: 96ef8dbed1ba36132d9cccfa608d1f90f879d7fb38cb5c18
turn_realm: nextcloud.meinit.nl
turn_total_quota: 100
turn_bps_quota: 0
turn_stale_nonce: 600
turn_no_loopback_peers: true
turn_no_multicast_peers: true
turn_simple_log: true
turn_cli_password: 5S4QtTbkC2tzJj4jRKePZJlmCVU3ljnG
turn_server_name: "{{ ansible_fqdn }}"
turn_listening_ip: "{{ ansible_default_ipv4.address }}"
turn_external_ip: "{{ ansible_default_ipv4.address }}"
Requirements
- Python packages listed in requirements.txt.
State of Used Roles
The following roles help prepare your system, but you can also set it up differently.
Requirement | GitHub | Version |
---|---|---|
buluma.bootstrap | ||
buluma.epel |
Context
This role is part of several compatible roles. Check the documentation of these roles for more info.
Here’s an overview of related roles:
Compatibility
This role has been tested on these container images:
Container | Tags |
---|---|
EL | 8 |
Debian | all |
Fedora | all |
Ubuntu | bionic |
The minimum required version of Ansible is 2.12. Tests have been conducted on:
- The previous version.
- The current version.
- The development version.
If you encounter issues, please report them on GitHub.
Changelog
License
Author Information
ansible-galaxy install buluma.turn