From efbc10675d488948a0257180723ba23f6afa7460 Mon Sep 17 00:00:00 2001 From: MichaIng <28480705+MichaIng@users.noreply.github.com> Date: Sun, 20 Jan 2019 03:24:17 +0100 Subject: [PATCH] Update TURN.md + turnserver.conf setting "lt-cred-mech" is obsolete/conflicting in combination with "use-auth-secret" + Info: On Debian Buster, respectively the related coturn version, a systemd unit has been implemented, superseding the init.d service. + Minor visual and wording changes Signed-off-by: Micha Felle --- docs/TURN.md | 25 +++++++++++++------------ 1 file changed, 13 insertions(+), 12 deletions(-) diff --git a/docs/TURN.md b/docs/TURN.md index 13ca75e5a..a2ae57a48 100644 --- a/docs/TURN.md +++ b/docs/TURN.md @@ -13,18 +13,19 @@ The configuration of Nextcloud Talk mainly depends on your desired usage: 2. **Make coturn run as daemon on startup** - On **Debian and Ubuntu** you just need to enable the deployed init.d service by adjusting the related environment variable: -`sudo sed -i '/TURNSERVER_ENABLED/c\TURNSERVER_ENABLED=1' /etc/default/coturn` + - `sudo sed -i '/TURNSERVER_ENABLED/c\TURNSERVER_ENABLED=1' /etc/default/coturn` + - On **Debian Buster** the most current package update implements a systemd unit, which does not use `/etc/default/coturn` but is enabled automatically after install. To check whether a systemd unit is available: + - `ls -l /lib/systemd/system/coturn.service` - On **other OS/distributions**, if you installed coturn manually, you may want to setup an init.d/systemd unit or use another method to run the following during boot: -`/path/to/turnserver -c /path/to/turnserver.conf -o` - - `-o` starts the server in daemon mode, `-c` defines the path to the config file. + - `/path/to/turnserver -c /path/to/turnserver.conf -o` + - `-o` starts the server in daemon mode, `-c` defines the path to the config file. -3. **Configure _turnserver.conf_ for usage with Nextcloud Talk**\ +3. **Configure _turnserver.conf_ for usage with Nextcloud Talk** At last you need to adjust the TURN servers configuration file to work with Nextcloud Talk. On Debian and Ubuntu, it can be found at `/etc/turnserver.conf`. The configuration depends on if you want to use TLS for secure connection or not. You may want to start without TLS for testing and then switch, if everything is working fine: - - **Without TLS** uncomment/adjust the following settings. Choose the listening port, e.g. `5349` (which is default value) and an authentication secret, where a random hex is recommended: `openssl rand -hex 32`: + - **Without TLS** uncomment/adjust the following settings. Choose the listening port, e.g. `3478` (default for non-TLS) or `5349` (default for TLS) and an authentication secret, where a random hex is recommended: `openssl rand -hex 32`: listening-port= fingerprint - lt-cred-mech use-auth-secret static-auth-secret= realm=your.domain.org @@ -37,7 +38,6 @@ At last you need to adjust the TURN servers configuration file to work with Next tls-listening-port= fingerprint - lt-cred-mech use-auth-secret static-auth-secret= realm=your.domain.org @@ -69,7 +69,7 @@ At last you need to adjust the TURN servers configuration file to work with Next 4. `sudo systemctl restart coturn` or corresponding restart method -5. **Configure Nextcloud Talk to use your TURN server**\ +5. **Configure Nextcloud Talk to use your TURN server** Go to Nextcloud admin panel > Talk settings. Btw. if you already have your own TURN server, you can and may want to use it as STUN server as well: STUN servers: your.domain.org: @@ -77,13 +77,14 @@ Go to Nextcloud admin panel > Talk settings. Btw. if you already have your own T TURN secret: UDP and TCP Do not add `http(s)://` here, this causes errors, the protocol is simply a different one. Also `turn:` or something as prefix is not needed. Just enter the bare `domain:port`. - -6. **Port forwarding**\ -If your TURN server is running **behind a NAT**, then don't forget to forward `` to the related machine. It needs to be available for the Talk users, not just the Nextcloud instance. + +6. **Port opening/forwarding**\ +The TURN server on `` needs to be available for all Talk participants, so you need to open it to the web and if your TURN server is running **behind a NAT**, forward it to the related machine. + ### What else Nextcloud Talk is still based on the Spreed video calls app (just got renamed on last major update) and thus the Spreed.ME WebRTC solution. For this reason all guides about how to configure coturn for one of them, applies to all of them. -**Futher reference**: +**Futher reference** - https://github.com/spreedbox/spreedbox/wiki/Use-TURN-server - https://github.com/nextcloud/spreed/issues/667