LiveKit

Prev Next

Available from Rocket.Chat 9.0.0 .

LiveKit is a built-in conference call provider that runs directly in the Rocket.Chat call window. Unlike external conference call providers, it doesn't require users to open a separate website or install an additional app. To enable LiveKit, connect a LiveKit server to your workspace, configure its connection details, and select it as the default conference call provider.

Prerequisites

Before you begin, make sure you have:

  • Rocket.Chat 9.0.0 or later

  • A premium plan and an active LiveKit add-on. LiveKit is available on Commercial, Government, and Defense plans. Contact the Sales team if you don’t have one.

  • A LiveKit server that your users' browsers and apps can reach, either self-hosted or LiveKit Cloud. See the official documentation for more details on setup.

  • Your LiveKit server credentials including its WebSocket URL, API key, and API secret.

Configure LiveKit

  1. Navigate to Manage > Workspace > Settings > Conference Call > LiveKit.

  2. Toggle on LiveKit Enabled.

  3. Fill in the LiveKit settings:

    Settings

    Description

    LiveKit URL

    The WebSocket address of your LiveKit server, for example wss://livekit.example.com.

    API Key

    The API key of your LiveKit server.

    API Secret

    The secret paired with the API key.

    Access token lifetime (hours)

    The maximum validity period of a participant's access token, in hours.

  4. Navigate back to Manage > Workspace > Settings > Conference Call.

  5. Toggle on Enable call window.

  6. In Default provider, select livekit. The livekit option appears in the list once Enable call window and LiveKit Enabled are on.

  7. Click Save changes.

Initiate calls using LiveKit

Once LiveKit is configured correctly, you can start conference calls immediately.

  1. In any room, click the video call icon from the room menu bar. The call opens in a new tab.

  2. Adjust your microphone, speaker, and camera settings.

  3. For direct messages, you can select Ring people before starting the call to notify the user. For other rooms, update the Call name and click Start Call.

Call controls

The following table describes several controls that help you manage the call effectively.

Control

Description

Mute/Unmute

Turn your microphone on or off and select your audio devices.

Video

Toggles your video on or off. Select your camera and video resolution.

Share screen

Share your screen or a specific application window with other participants.

Raise hand

Raise or lower your hand to indicate that you want to speak. Raised hands appear in a queue so participants can see who wants to speak next.

React

Send an emoji reaction during the call.

Layout and Connection info

Click the kebab menu to access the layout selection and connection info:

  • Switch between Grid, Spotlight, and Sidebar layouts to change how participants and shared screens appear.

  • View call connection and performance statistics, including bandwidth, latency, and video resolution.

Participants

View the people currently in the call and see who is participating.

Chat

Send messages to other participants during the call. Messages are also posted in the call's thread in the corresponding workspace room, so participants can access the conversation outside the call.