No description
  • Jinja 70.8%
  • Shell 21%
  • Just 8.2%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-02 21:57:50 +00:00
.github CI: test on ubuntu2604 only 2026-08-27 07:43:13 +03:00
bin Derive release tags from defaults/main.yml instead of commit messages 2026-08-24 17:28:21 +03:00
defaults Update ghcr.io/jitsi/web Docker tag to stable-11248-3 2026-11-02 21:57:50 +00:00
docs Document granting the moderator role based on JWT claims 2026-10-13 10:36:10 +03:00
LICENSES Make the project compliant with REUSE 2025-02-15 01:19:25 +09:00
meta Update meta/main.yml: credit author properly 2026-08-27 10:57:33 -04:00
molecule Update pre-commit repositories and hooks 2026-10-29 02:05:52 -08:00
tasks Replace jitsi_web_framing_* with jitsi_web_http_header_content_security_policy_frame_ancestors_* 2026-10-13 09:46:06 +03:00
templates Add jitsi_jicofo_auto_owner_enabled 2026-10-13 10:34:57 +03:00
.ansible-lint Enable pre-commit 2025-07-12 13:26:29 +09:00
.gitignore Add a Molecule test scenario 2026-08-24 17:57:10 +03:00
.pre-commit-config.yaml Update pre-commit repositories and hooks 2026-10-29 02:05:52 -08:00
.python-version Add a Molecule test scenario 2026-08-24 17:57:10 +03:00
.yamllint.yml Run ansible-lint --fix for tasks/ 2025-06-25 23:53:39 -04:00
justfile justfile: git hooks resolve prek through the mise shim 2026-08-25 17:16:07 +03:00
LICENSE Initial commit 2023-04-02 09:30:50 +03:00
mise.toml mise: drop the settings block - yes is ignored in project configs 2026-08-16 09:25:56 +03:00
README.md Update README.md: add a section about releases 2026-10-02 02:16:23 -04:00
REUSE.toml Add a Molecule test scenario 2026-08-24 17:57:10 +03:00

Jitsi Ansible role

REUSE status

This is an Ansible role which installs Jitsi to run as a bunch of Docker containers wrapped in systemd services. The architecture is inspired by the docker-jitsi-meet project, but does not use Docker Compose.

This role implicitly depends on:

Check defaults/main.yml for the full list of supported options. Refer to this page for details about setting up the service with this role.

💡 For an Ansible playbook which integrates this role and makes it easier to use, see the Mother-of-All-Self-Hosting Ansible playbook.

Development

pre-commit

You can optionally install a Git pre-commit hook (via mise + prek) that runs formatting and linting checks before each commit. See .pre-commit-config.yaml for which hooks are to be executed.

To install the hook, run the just command below:

just prek-install-git-pre-commit-hook

Molecule

This role supports Molecule, an Ansible testing framework designed for developing and testing Ansible collections, playbooks, and roles.

Refer to this page for details about how to utilize it.

Releases

Tags are created on the GitHub workflow by .github/workflows/autotag.yml, which asks bin/compute-next-tag.sh what the commit on main should be released as. The answer comes from the version pinned in defaults/main.yml and from the tags that already exist, so a commit that only touches documentation or CI is not released at all, and any change to the role itself is — without waiting for a dependency bump to carry it along.

bin/test-compute-next-tag.sh exercises that script against throwaway repositories, and runs as a prek hook.