Skip to content

Configure Zulip: enable BigBlueButton integration

To use the BigBlueButton video call integration on a self-hosted Zulip installation, you’ll need to have a BigBlueButton server and configure it:

  1. Get the Shared Secret using the bbb-conf --secret command on your BigBlueButton Server. See also the BigBlueButton documentation.

  2. Get the URL to your BigBlueButton API. The URL has the form of https://bigbluebutton.example.com/bigbluebutton/ and can also be found using the bbb-conf --secret command.

You can then configure your Zulip server to use that BigBlueButton Server as follows:

  1. In /etc/zulip/zulip-secrets.conf, set big_blue_button_secret to be your BigBlueButton Server’s shared secret.

  2. In /etc/zulip/settings.py, set BIG_BLUE_BUTTON_URL to your to be your BigBlueButton Server’s API URL.

  3. Restart the Zulip server with /home/zulip/deployments/current/scripts/restart-server.

This enables BigBlueButton support in your Zulip server. Finally, configure BigBlueButton as the video call provider in the Zulip organization(s) where you want to use it.