Meet (Visio) Integration¶

Calendars supports video conference links via Meet (LiveKit-based). Events can include a "Visio" link that attendees click to join a video call.

Configuration¶

Add the Meet base URL to the Calendars .env:

FRONTEND_MEET_BASE_URL=https://visio6.<domain>

Restart the Calendars backend:

docker compose up -d backend

When creating an event in Calendars, a "Add video conference" section appears. Calendars auto-creates a Meet room and embeds the link in the event.

Guest Auto-Join (Lobby Disabled)¶

By default, Meet has a lobby/waiting room feature. When an attendee joins before the room creator, they are placed in a waiting screen and the host must manually accept them. This is often unwanted for calendar-invited meetings.

Disable the Lobby¶

Add these settings to the Meet .env:

ALLOW_UNREGISTERED_ROOMS=True
LOBBY_WAITING_TIMEOUT=0
LOBBY_ACCEPTED_TIMEOUT=0
LOBBY_DENIED_TIMEOUT=0

Setting	Before	After	Effect
`ALLOW_UNREGISTERED_ROOMS`	`False`	`True`	Guests can join rooms without authentication
`LOBBY_WAITING_TIMEOUT`	`3`	`0`	No waiting before auto-accept
`LOBBY_ACCEPTED_TIMEOUT`	`21600`	`0`	No persistence of acceptance state
`LOBBY_DENIED_TIMEOUT`	`5`	`0`	No denial timeout

Restart the Meet backend:

docker compose up -d backend

With these settings, any guest clicking a video link goes straight into the room — no waiting screen, no host approval needed.

Remove Duplicate Entries¶

If ALLOW_UNREGISTERED_ROOMS appears twice in .env (from previous configuration), remove the old entry. Docker Compose uses the last occurrence, but it's cleaner to have a single entry.

grep -n "ALLOW_UNREGISTERED_ROOMS" .env
# Delete the old line, keep only the True one

Troubleshooting¶

Attendee stuck at waiting screen¶

Symptom: Attendee clicks the video link, sees a waiting/loading screen that never resolves, even after the host joins.

Cause: The Meet lobby is enabled. Unauthenticated guests are placed in a waiting room requiring host approval.

Fix: Set LOBBY_WAITING_TIMEOUT=0 and ALLOW_UNREGISTERED_ROOMS=True in the Meet .env.

Video conference option not showing in Calendars¶

Symptom: No "Add video conference" button when creating events.

Fix: Set FRONTEND_MEET_BASE_URL in Calendars .env and restart the backend.

Room creation fails from Calendars¶

Symptom: Error when creating the video link from Calendars UI.

Check: Ensure the Meet instance is running and accessible at the configured URL:

curl -s -o /dev/null -w "%{http_code}" https://visio6.<domain>/

Expected: 200