https://github.com/systemli/ansible-role-jitsi-meet

Ansible role to install & configure Jitsi Meet
https://github.com/systemli/ansible-role-jitsi-meet

ansible-role jitsi-meet

Last synced: 3 months ago
JSON representation

Ansible role to install & configure Jitsi Meet

• Host: GitHub
• URL: https://github.com/systemli/ansible-role-jitsi-meet
• Owner: systemli
• License: gpl-3.0
• Created: 2020-03-23T15:53:37.000Z (almost 5 years ago)
• Default Branch: main
• Last Pushed: 2024-02-05T08:44:23.000Z (12 months ago)
• Last Synced: 2024-03-26T20:44:23.488Z (10 months ago)
• Topics: ansible-role, jitsi-meet
• Language: Jinja
• Size: 261 KB
• Stars: 42
• Watchers: 10
• Forks: 18
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Ansible role to install and configure Jitsi Meet

[![Build Status](https://github.com/systemli/ansible-role-jitsi-meet/workflows/Integration/badge.svg?branch=main)](https://github.com/systemli/ansible-role-jitsi-meet/actions?query=workflow%3AIntegration)

[![Ansible Galaxy](http://img.shields.io/badge/ansible--galaxy-jitsi_meet-blue.svg)](https://galaxy.ansible.com/systemli/jitsi_meet/)

This role installs and configure [Jitsi Meet](https://jitsi.org/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`](defaults/main.yml) for further available variables.

## Dependencies

- [systemli.apt_repositories](https://galaxy.ansible.com/systemli/apt_repositories)

## Download

Download latest release with `ansible-galaxy`

```shell

ansible-galaxy install systemli.jitsi_meet

```

## Example Playbook

```yaml

- 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

```shell

pip install molecule-vagrant ansible-lint yamllint

molecule test

```

This requires [Vagrant](https://www.vagrantup.com/downloads.html) to be installed.

## Debugging

For local debugging you can run the following commands:

```shell

molecule create

molecule converge

```

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

## Remove Jitsi

```shell

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