Skip to main content

Setting Up Jitsi and TURN With the Installer

Configure the Installer to install Jitsi and TURN

Prerequisites

Firewall

You will have to open the following ports to your microk8s host to enable coturn and jitsi :

For jitsi :

  • 30301/tcp
  • 30300/udp

For coturn, allow the following ports :

  • 3478/tcp
  • 3478/udp
  • 5349/tcp
  • 5349/udp

You will also have to allow the following port range, depending on the settings you define in coturn.yml (see below) :

  • <coturn min port>-<coturn max port>/udp

DNS

The jitsi and coturn domain names must resolve to the VM access IP. You must not use host_aliases for these hosts to resolve to the private IP locally on your setup.

Coturn

  • Copy sample file from config-sample/coturn/coturn.yml to the coturn sub-directory within your config folder
  • Edit the file and add the following values :
    • coturn_fqdn: The access address to coturn. It should match something like coturn.<fqdn.tld>. It must resolves to the public-facing IP of the VM.
    • shared_secret: A random value, you can generate it with pwgen 32
    • min_port: The minimal UDP Port used by coturn for relaying UDP Packets, in range 32769-65535
    • max_port: The maximum UDP Port used by coturn for relaying UDP Packets, in range 32769-65535

Jitsi

  • Copy sample file from config-sample/jitsi/jitsi.yml to the jitsi sub-directory within your config folder
  • Edit the file and add the following values :
    • jitsi_fqdn: The access address to jitsi. It should match something like jitsi.<fqdn.tld>. It must resolves to the public-facing IP of the VM.
    • jicofo_auth_password: # a secret internal password for jicofo auth
    • jicofo_component_secret: # a secret internal password for jicofo component
    • jvb_auth_password: # a secret internal password for jvb
    • helm_override_values: {} # if needed, to override helm settings automatically set by the installer
    • timezone: Europe/Paris # The timezone in TZ format
    • stun_servers: "ip:port" Needed if you don't setup coturn using the installer. Should be a yaml list of server:port entries. Must be surrounded by double quotes.Example:
    stun_servers: 
    - ip:port
    - ip:port
    

Element

  • Copy sample file from config-sample/element/jitsi.json to the element sub-directory within your config folder
  • Edit the file and replace <jitsi_fqdn> by the value of jitsi fqdn.

Restart the install script once everyting is set.

Configure the installer to use an existing Jitsi instance

  • Create a file called jitsi.json in the ~/.element-onpremise-config/element directory.
  • Edit the file :
{
      "jitsi": {
            "preferredDomain": "your.jitsi.example.org"
      }
}

replacing your.jitsi.example.org with the hostname of your Jitsi server.

  • Restart the install script

Configure the installer to use an existing Coturn instance

Follow the instructions here: https://ems-docs.element.io/books/element-on-premise-documentation/page/single-node-installations#bkmrk-turn-server