matrix-docker-ansible-deploy/docs/configuring-playbook-jitsi.md
2020-03-24 15:30:14 +02:00

1.6 KiB

Jitsi

The playbook can install the Jitsi video-conferencing platform and integrate it with Riot.

Jitsi installation is not enabled by default, because it's not a core component of Matrix services.

The setup done by the playbook is very similar to docker-jitsi-meet.

Prerequisites

Before installing Jitsi, make sure you've created the jitsi.DOMAIN DNS record. See Configuring DNS.

You may also need to open the following ports to your server:

  • udp/10000 - RTP media over UDP
  • tcp/4443 - RTP media fallback over TCP

Installation

Add this to your inventory/host_vars/matrix.DOMAIN/vars.yml configuration:

matrix_jitsi_enabled: true

# We only need this temporarily - until Jitsi integration in riot-web is finalized.
# Remove this line in the future, to switch back to a stable riot-web version.
matrix_riot_web_docker_image: "vectorim/riot-web:develop"

Then re-run the playbook: ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,start

Usage

You can use the self-hosted Jitsi server through Riot, through an Integration Manager like Dimension or directly at https://jitsi.DOMAIN.

To use it via riot-web, make sure you've installed the develop version and fully reloaded your riot-web page (at riot.DOMAIN). Starting a video-conference in a room containing more than 2 members should then create a Jitsi widget which utilizes your self-hosted Jitsi server.