mod_turn_external

Easily connect a TURN/STUN server by enabling this module.

This module is not yet included with Prosody, it’s currently only available in trunk builds and will be in the next major release.

Usage

modules_enabled = {
    -- other modules
    "turn_external",
}

-- a secret shared with the turn server is the only required setting
turn_external_secret = "aGVtbGlndAo="

-- if the service is hosted on a hostname that differs from name of virtualhost
turn_external_host = "turn.example.com"

-- if a non-standard port is used
turn_external_port = 3478

Configuration

turn_external_secret: A secret shared with the TURN server, used to dynamically generate credentials. required
turn_external_user: Suffix to use for generated usernames, if the TURN server uses this.
turn_external_ttl: How long the generated credential are valid, defaults to 86400 = 1 day.
turn_external_host: DNS hostname of the TURN (and STUN) server, defaults to same as VirtualHost.
turn_external_port: Port number used by TURN (and STUN) server, defaults to 3478.
turn_external_tcp: Whether to announce TURN (and STUN) over TCP (uncommon).
turn_external_tls_port: Port offering TURN over TLS (uncommon).