ansible-role-jitsi-docker/README.md
Jan Beilicke b4855c6a66 Several improvements (see below); New default: Only last 3 speakers will be have active video
- Remove Jitsi runtime config in case of Ansible tag teardown
- Performance: DefautSet Jitsi Web config channelLastN using jitsi_web_channel_last_n
- Adds submodule with the source of docker-jitsi-meet, which this role is based on.
2020-05-01 23:24:17 +02:00

60 lines
4.4 KiB
Markdown

Jitsi Meet (Docker-Compose)
===========================
A single-instance [Jitsi Meet](https://jitsi.org/jitsi-meet/) server that can be run behind [Traefik](https://traefik.io).
Requirements
------------
- Ansible (implemented and tested with v2.9)
- Ubuntu or Debian server
- [Docker Engine](https://docs.docker.com/install/) + [Docker Compose](https://docs.docker.com/compose/install/)
- Optional: Traefik
Role Variables
--------------
| Variable | Description | Default |
| --------------------------- | ------------------------------------------------------------------------------- | ------------------ |
| docker_user | The user who is going to manage/run the Docker Compose services | deploy |
| *jitsi_letsencrypt_email* | E-Mail adress used for requesting certificates | Not set |
| jitsi_docker_host_address | | |
| jitsi_enable_letsencrypt | Jitsi will take care of Let's Encrypt certificates | 0 |
| jitsi_exposed_http_port | Exposed container port for HTTP | 8000 |
| jitsi_exposed_https_port | Exposed container port for HTTPS | 8443 |
| jitsi_jibri_recorder_password | Provide a secure password\* | |
| jitsi_jibri_recorder_user | | |
| jitsi_jibri_xmpp_password | | |
| jitsi_jibri_xmpp_user | | |
| jitsi_jicofo_auth_password | | |
| jitsi_jicofo_auth_user | | |
| jitsi_jicofo_component_secret | | |
| jitsi_jigasi_xmpp_password | | |
| jitsi_jigasi_xmpp_user | | |
| jitsi_jvb_auth_password | | |
| jitsi_jvb_auth_user | | |
| jitsi_jvb_stun_servers | | meet-jit-si-turnrelay.jitsi.net:443 |
| jitsi_web_channel_last_n | Performance: Limit video streams to the last N speakers (-1 = unlimited) | 3 |
| jitsi_public_url | The public URL under which Jitsi Meet can be accessed | http://localhost |
| jitsi_timezone | | Europe/Amsterdam |
| jitsi_virtual_host | The virtual host that is e.g. used by Traefik, usually part of the public url | localhost |
\* It is important to provide a dedicated secure password for each service. Generate passwords with e.g. `openssl rand -hex 16`
Dependencies
------------
Example Playbook
----------------
License
-------
MIT
Author Information
------------------
This role was created in 2020 by [Jan Beilicke](https://jotbe.io).