Setting up Jitsi for Video

Setting up Jitsi (optional)

To enable the video conference capabilities in ISLE, which are powered by [Jitsi][jitsi], you need to connect to a specified Jitsi server.

• To setup a new Jitsi server, follow the instructions in their Quick Install guide. As of March 2020, installing Jitsi on Ubuntu 16.04 should work out of the box when following these instructions; other distributions or newer Ubuntu versions yield installation issues that have to be manually resolved.

• Install prosody:

wget https://packages.prosody.im/debian/pool/main/p/prosody-trunk/prosody-trunk_1nightly747-1~xenial_amd64.deb

dpkg -i prosody-trunk_1nightly747-1~xenial_amd64.deb

• Install jitsi-meet-tokens via command

apt-get install jitsi-meet-tokens

• Change the Prosody configuration to use [JSON web tokens][jwt] for authentication.

• Make sure that the Prosody app_id and app_secret match corresponding appId and appSecret fields in the credentials/jitsi.json file of the cloned isle-server repository.

• Finally, the server field in credentials/jitsi.json should be set to the FQDN of the Jitsi Meet instance.

• To change the default appearance of Jitsi meet, the interface_config.js file in /usr/share/jitsi-meet should be updated. Refer to the version of the file inside the etc/jitsi-meet folder of this repository for the Jitsi interface configuration used in ISLE.

Jibri for Jitsi Recordings + Live Streaming (optional)

The following video tutorial describes the steps involved in setting up one or more [Jibri][jibri] instances on other servers for recording Jitsi Meet sessions in ISLE:

https://jitsi.org/news/learn-how-to-live-stream-and-record-on-your-jitsi-meet-install/

Newer versions of Chrome require an additional step. From the Jibri README.md file:

Add chrome managed policies file and set CommandLineFlagSecurityWarningsEnabled to false. It will hide warnings in Chrome. You can set it like so:

mkdir -p /etc/opt/chrome/policies/managed
echo '{ "CommandLineFlagSecurityWarningsEnabled": false }' >>/etc/opt/chrome/policies/managed/managed_policies.json

Troubleshooting: In case of Java errors encountered the logs in /var/log/jitsi/jibri, it is advised to [install Java 8][install-java8].

To set it as the default:

sudo update-java-alternatives --list
sudo update-java-alternatives --set java-1.8.0-openjdk-amd64