fast-hairdresser-13908
12/23/2025, 7:23 AMtall-airline-16756
12/23/2025, 7:23 AMtall-airline-16756
12/23/2025, 7:24 AMfilepath or filename_prefix to a local path (e.g., /path/to/local/folder/recording.mp4).
• Ensure the Egress service/process (or its Docker container) has write permission to that folder — when using Docker, mount the host directory as a volume so the file is accessible.
If you’d like, tell me which egress type you’re using (Room Composite, Track, or Track Composite) and whether you run Egress as a local binary or in Docker, and I’ll give the exact request snippet and Docker mount example.
Sources: Egress API | LiveKit docs | RoomComposite Egress | LiveKit Docs | Egress examples | LiveKit docs | Egress output types | LiveKit docs | Self-hosting the Egress Service | LiveKit docsfast-hairdresser-13908
12/23/2025, 7:26 AMtall-airline-16756
12/23/2025, 7:26 AMgstreamer, gst-plugins-base, gst-plugins-good, gst-plugins-bad, gst-plugins-ugly, gst-libav).
2. Create an config.yaml for the Egress service with your API key/secret, ws_url (use <ws://localhost:7880> for local), and Redis address (localhost:6379).
3. Run Egress (example Docker command):
docker run --rm \
--cap-add SYS_ADMIN \
-e EGRESS_CONFIG_FILE=/out/config.yaml \
-v ~/livekit-egress:/out \
-p 1935:1935 -p 8080:8080 \
livekit/egress
• If using Docker, mount a host directory so recordings written to a local filepath are persisted and accessible.
• Use <ws://host.docker.internal:7880> and host.docker.internal:6379 on macOS/Windows if needed.
1. Start recordings via the Egress API/CLI/SDK. Include roomRecord permission in the access token.
2. To save files locally, specify a local filepath (or filename_prefix) in the egress request (e.g., /path/to/folder/recording.mp4) and ensure the Egress process has write permission to that path.
Would you like:
• An exact egress request snippet for Room Composite or Track egress?
• A Docker compose example that mounts the output directory for you? Sources: LiveKit Pricing | Recording and export | LiveKit docs | Self-hosting the Ingress Service | LiveKit docs | Self-hosting the Egress Service | LiveKit docs | Egress API | LiveKit docs