matrix-docker-ansible-deploy/docs/configuring-playbook-jitsi.md

# Jitsi

The playbook can install the [Jitsi](https://jitsi.org/) video-conferencing platform and integrate it with [Riot](configuring-playbook-riot-web.md).

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](https://github.com/jitsi/docker-jitsi-meet).


## Prerequisites

Before installing Jitsi, make sure you've created the `jitsi.DOMAIN` DNS record. See [Configuring DNS](configuring-dns.md).

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

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


## Installation

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

```yaml
matrix_jitsi_enabled: true
```

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](docs/configuring-playbook-dimension.md) or directly at `https://jitsi.DOMAIN`.

To use it via riot-web (the one configured by the playbook at `https://riot.DOMAIN`), just start a voice or a video call in a room containing more than 2 members and that would create a Jitsi widget which utilizes your self-hosted Jitsi server.
Add Jitsi support 2020-03-23 16:19:15 +01:00			`# Jitsi`

			`The playbook can install the [Jitsi](https://jitsi.org/) video-conferencing platform and integrate it with [Riot](configuring-playbook-riot-web.md).`

			`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](https://github.com/jitsi/docker-jitsi-meet).`


			`## Prerequisites`

			Before installing Jitsi, make sure you've created the `jitsi.DOMAIN` DNS record. See [Configuring DNS](configuring-dns.md).

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

Flip around Jitsi port format to match other ports This matches the way the ports are written in prerequisites.md and is the format that UFW likes. 2020-03-28 05:33:38 +01:00			- `10000/udp` - RTP media over UDP
			- `4443/tcp` - RTP media fallback over TCP
Add Jitsi support 2020-03-23 16:19:15 +01:00

			`## Installation`

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

			```yaml
			`matrix_jitsi_enabled: true`
			```

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


Update documentation and changelog 2020-03-24 14:30:14 +01:00			`## Usage`

			You can use the self-hosted Jitsi server through Riot, through an Integration Manager like [Dimension](docs/configuring-playbook-dimension.md) or directly at `https://jitsi.DOMAIN`.

Upgrade riot-web 2020-03-30 15:54:18 +02:00			To use it via riot-web (the one configured by the playbook at `https://riot.DOMAIN`), just start a voice or a video call in a room containing more than 2 members and that would create a Jitsi widget which utilizes your self-hosted Jitsi server.