Skip to content

systemli/ansible-role-jitsi-meet

Repository files navigation

Ansible role to install and configure Jitsi Meet

Build Status Ansible Galaxy

This role installs and configure Jitsi Meet with nginx Webserver and prosody as XMPP Server.

It is maintained with Debian Buster in mind, but should also work with its derivatives like Ubuntu 20.04.

Role Variables

You need to set the jitsi_meet_base_secret variable from which passwords for the various internally used accounts are created.

See defaults/main.yml for further available variables.

Dependencies

Download

Download latest release with ansible-galaxy

ansible-galaxy install systemli.jitsi_meet

Example Playbook

- hosts: jitsimeetservers
  roles:
     - { role: systemli.letsencrypt }
     - { role: systemli.jitsi_meet }
  vars:
    jitsi_meet_server_name: "meet.example.com"
    letsencrypt_cert:
      name: "{{ jitsi_meet_server_name }}"
      domains:
        - "{{ jitsi_meet_server_name }}"
      challenge: dns

Caveats

A change of the jitsi_meet_server_name variable applied on an already deployed instance is going to break the configuration.

Tests

We do integration tests with GitHub Actions and Molecule.

Locally, you can easily test the role with

pip install molecule-vagrant ansible-lint yamllint
molecule test

This requires Vagrant to be installed.

Debugging

For local debugging you can run the following commands:

molecule create
molecule converge

This will spin up an instance which is reachable via https://localhost:8443/.

Remove Jitsi

sudo apt purge jigasi jitsi-meet jitsi-meet-web-config jitsi-meet-prosody jitsi-meet-turnserver jitsi-meet-web jicofo jitsi-videobridge2 nginx* jitsi* prosody lua5.2
sudo apt autoremove --purge
sudo rm -r /etc/jitsi/ /usr/share/jitsi-meet/ /usr/share/jitsi-videobridge/ /etc/prosody/ /var/lib/prosody/ /etc/apt/sources.list.d/download_jitsi_org.sources /etc/apt/sources.list.d/packages.prosody.im.sources /etc/apt/preferences.d/download_jitsi_org.pref /etc/apt/preferences.d/packages.prosody.im.pref

License

GPLv3

Author Information

https://www.systemli.org