Enabling additional features

Some features are disabled by default because they require some further configuration.

Video calling

As described on the external systems page, LiveKit is used.

Here are the steps for activating video calling on your instance:

1. Set the LiveKit options as described in the Meet section on the settings page.

   WARNING

   If you are setting MEET_LIVEKIT_ENDPOINT via abra app config or directly, make sure that the URL scheme is http or https and not wss as suggsted by LiveKit.

2. The LiveKit endpoint needs to be added with both schemes WSS and HTTP(S) to the Content Security Policy (CSP).

   With abra app config, you need to set the environment variable CSP_CONNECT_SRC:

   CSP_CONNECT_SRC="https://my.example.endpoint wss://my.example.endpoint"

3. Enable the feature per group.

   Open a Django shell:

   abra app run <domain> app -- python -m karrot.cli shell

   # Get the group by ID. Replace <your id> with a number.
   group = Group.objects.get(id=<your id>)
   
   # Check its currently enabled features. (optional)
   group.features
   
   # Append the feature name to the list.
   group.features.append('meet')
   
   # Verify its new value. (optional)
   group.features
   
   # Save the change.
   group.save()

4. You should now see a video call button at every upcoming activity you joined.