Plugin settings¶
All of mod_jitsi's site-wide options live in a single admin page:
Site administration → Plugins → Activity modules → Jitsi
This page reads from settings.php. The sections below follow the same order and grouping
as the settings page itself. Defaults are shown where the plugin defines one.
Server-specific settings
Some sections only apply to certain server types. Dropbox recording is ignored on 8x8 (JaaS) servers, and the GCP section only applies when you let the plugin provision a server in Google Cloud. See Server options.
mod_jitsi Account¶
A status panel at the top of the page lets you connect your installation to the mod_jitsi Account portal. Some features (attendance report, recording view tracking, viewing heatmap, course overview, session usage statistics) require this registration.
Connect your installation to the mod_jitsi Account to share usage statistics and get access to upcoming features. Your site name and URL will be stored to identify your installation.
Depending on state, the panel shows a Register & enable button, a Waiting for registration notice with a resend link, or a Connected confirmation with an unregister link.
Server management¶
| Setting | What it does | Default |
|---|---|---|
| Jitsi servers (link) | Link to the server management page where Jitsi servers are added and managed, plus a link to Session usage statistics. | — |
| Jitsi server | Choose which Jitsi server will be used. The list is populated from the servers you have defined. | First available server |
Configuration¶
| Setting | What it does | Default |
|---|---|---|
| Help | Customizes the help tab text shown in Jitsi activities. A good place for netiquette rules or user help instructions. | empty |
| ID User | ID to show in the session. Options: Username, Firstname + Lastname, or Alias. | Username |
| Separator | Field separator for the session name. Options: ., -, _, or empty. |
. |
| Session name fields | Fields that define the session name (Course Shortname, Session ID, Session Name). | All three |
| Invite Options | Allow users with the mod/jitsi:createlink capability (teachers) to create invite links for users not enrolled in the course. |
On |
| Send invitation by email | Allow teachers to send the invitation link directly by email from the session page. | Off |
| Show Background options | Show the "Select Background" option to all users. This feature requires powerful computers, so you may want to disable it. | On |
| Youtube sharing option | Show the YouTube video sharing option. | On |
| Finish and Return | Return to the course when the session finishes. On public Jitsi, users return to the course when they close the advertising. | On |
| Deep Link | When on the Moodle app, allows transferring Jitsi sessions to the Jitsi app. | On |
| Password | Password to secure your sessions. Recommended if you use a public server. | empty |
| Security Button | Enables native Jitsi "Security Options" and "Lobby mode". Disable if you set a password above (the password would be displayed to users). Works best with token configuration. | Off |
| Show avatars in Jitsi | Show the user's avatar in Jitsi. Falls back to the default Moodle profile picture if the user has none. | On |
| Record | Enable native Jitsi recording options (currently Dropbox) for users with mod/jitsi:record (teachers). Disable if you use the "Moodle integrated" streaming method. |
On |
| Participants panel | Show the participants panel to all users. When off, only users with mod/jitsi:moderation (usually teachers) can see the panel. |
On |
| Raise hand button | Show the raise-hand button to all users. Raising a hand also gives access to the participants panel. | On |
| Reactions | Shows sound emoticons (applause, surprise, etc.). Requires the "Raise hand button" to be enabled. | On |
| Chat | Enable the chat for all participants. | On |
| Polls | Enable the polls feature for all participants. Polls are always disabled when chat is disabled. | On |
| Whiteboard | Show the whiteboard button to all users. The whiteboard is not available on JaaS servers. | On |
| Start with audio muted | When a user connects to the session, the audio is muted. | On |
| Start with video muted | When a user connects to the session, the video is muted. | On |
| Simultaneous cameras | Maximum simultaneous cameras a user can see. May be overridden by your Jitsi server with a lower value. Too many cameras can overload client browsers. | 15 |
| Allow breakout rooms | Allow creating breakout rooms. The server must be configured to allow breakout rooms. | On |
| Enable transcription | Enable the transcription feature in Jitsi sessions. When disabled, the option is hidden from participants regardless of server configuration. | On |
| Send user email to Jitsi | Sends the user's Moodle email address to the Jitsi server (required by some server features such as recording delivery by email). Shares personal data with the Jitsi server — ensure compliance with your privacy policy. | Off |
| Private sessions | Add private 1-on-1 sessions to user profiles. | Off |
Dropbox recording configuration¶
Not used on 8x8 (JaaS) servers
These settings are ignored when the active server is 8x8. Dropbox recording is only available for self-hosted Jitsi servers.
You need to create an app at the Dropbox App Console and set the redirect URI there.
| Setting | What it does | Default |
|---|---|---|
| Dropbox App Key | The App Key from your Dropbox app (Dropbox Developer Console → your app → Settings tab). | empty |
| Dropbox Redirect URI | The OAuth2 redirect URI registered in your Dropbox app. Must match exactly what you set in the Dropbox App Console. Usually https://your-jitsi-domain/static/oauth.html. |
empty |
Streaming configuration¶
Default streaming works out of the box: users stream/record with their own accounts (YouTube, PeerTube…) and the teacher publishes the watch links to students. For a better experience, enable the "Moodle integrated" method to record to a corporate account (YouTube only) with recordings automatically available to students.
| Setting | What it does | Default |
|---|---|---|
| Live Streaming | Enable the Live Streaming features for users with mod/jitsi:record (teachers). If enabled, you may want to disable the "Record" option above. |
On |
| Live Streaming Method | Jitsi interface: users stream with their own accounts via the Jitsi UI. Moodle integrated: teachers start "Record & Stream" with no credentials; recordings are stored in a corporate account and available to students immediately (requires OAuth2 credentials and a streaming account). | Jitsi interface |
| OAuth2 id | OAuth2 id of a Google account with the YouTube Data API v3 enabled, with the authorized redirect URI shown in the setting (…/mod/jitsi/auth.php). |
empty |
| OAuth2 secret | OAuth2 secret of the Google account. | empty |
| Number of videos to delete | Number of videos to delete on each execution of the cron task. | 1 |
| Retention period | How long a deleted video stays available on the streaming server before being deleted from it. | 4 weeks |
| Latency | Latency level for streaming: Normal, Low or Ultra Low. | Normal |
| For kids | Recordings will be deemed to have been created for children. | Off |
Management links¶
The streaming section also exposes direct links to administration pages:
- Streaming/Recording Accounts — manage the corporate YouTube accounts.
- Recordings available to delete — list of recordings marked for deletion.
- Recordings on air — live sessions currently recording.
- Search recordings.
- Jitsi Recording Statistics.
Google Cloud (GCP) — BETA¶
Configure the project and VM where the shared Jitsi server will be deployed. This feature is in beta testing.
| Setting | What it does | Default |
|---|---|---|
| Project ID | Google Cloud project ID (e.g. my-project). |
empty |
| Zone | Compute Engine zone where Jitsi and Jibri VMs will be created. | europe-west1-b |
| Base image | Image to use for the VM. | Debian 12 family |
| Network | VPC/network to attach the instance to (e.g. global/networks/default). |
global/networks/default |
| Hostname (FQDN) | Fully-qualified domain name that will point to the VM (required for Let's Encrypt). | empty |
| Let's Encrypt email | Email address used to request the Let's Encrypt certificate. | empty |
| Service Account JSON | Upload the Service Account JSON with permissions to manage Compute Engine. | — |
See GCP setup for the full provisioning walkthrough.
AI Features¶
Configure AI-powered features for GCS recordings (summary, quiz, transcription). These features send recording content to Google Vertex AI. Ensure a Data Processing Agreement with Google Cloud is in place before enabling.
| Setting | What it does | Default |
|---|---|---|
| Enable AI features | Enable AI-powered summary, quiz and transcription for GCS recordings. When enabled, video recordings are sent to Google Vertex AI for processing. Ensure your institution has a DPA with Google Cloud and the region complies with applicable data protection (e.g. GDPR). | Off |
| Number of questions for AI quiz | Number of true/false questions to generate per recording (3–20). | 10 |
| Vertex AI region | Region where Vertex AI (Gemini) requests are processed. Choose an EU region for GDPR; the region must support Gemini 2.5 Flash. | europe-west1 |
Experimental¶
These are options that we are experimenting with and that may disappear in future versions.
| Setting | What it does | Default |
|---|---|---|
| Share stream with users outside of Moodle | Offer the ability to share the live stream of a session with users outside of Moodle. | Off |