matrix-docker-ansible-deploy/docs/configuring-playbook-jwt-service.md

Setting up JWT Service (optional)

The playbook can install and configure LiveKit JWT Service for you.

LK-JWT-Service is currently used for a single reason: generate JWT tokens with a given identity for a given room, so that users can use them to authenticate against LiveKit SFU.

See the project's documentation to learn more.

Decide on a domain and path

By default, JWT Service is configured to be served:

• on the Matrix domain (matrix.example.com), configurable via matrix_livekit_jwt_service_hostname
• under a /lk-jwt-service path prefix, configurable via matrix_livekit_jwt_service_path_prefix

This makes it easy to set it up, without having to adjust your DNS records manually.

Adjusting DNS records

If you've changed the default hostname, you may need to adjust your DNS records accordingly to point to the correct server.

Adjusting the playbook configuration

Add the following configuration to your inventory/host_vars/matrix.example.com/vars.yml file:

matrix_livekit_jwt_service_enabled: true

Installing

After configuring the playbook and potentially adjusting your DNS records, run the installation command: just install-all or just setup-all

Usage

Once installed, a new org.matrix.msc4143.rtc_foci section is added to the Element Web client to point to your JWT service URL (e.g., https://matrix.example.com/lk-jwt-service).

Additional Information

Refer to the LiveKit JWT-Service documentation for more details on configuring and using JWT Service.