plugin livekit - nself-org/cli GitHub Wiki
LiveKit Plugin
Video and audio conferencing with recording, egress, and quality monitoring. Pro plugin.
Requires: Basic license tier or higher.
nself license set nself_pro_...
Install
nself license set nself_pro_xxxxx...
nself plugin install livekit
What It Does
Integrates a LiveKit server into your ɳSelf stack for WebRTC video and audio conferencing. Create rooms, generate participant tokens, record sessions to MinIO or S3, stream egress to RTMP endpoints, and monitor per-participant quality metrics. Used by the ɳSelf Chat and Claw client apps for voice and video calling.
Configuration
| Env Var | Default | Description |
|---|---|---|
LIVEKIT_PORT |
3107 |
LiveKit management API port |
LIVEKIT_API_KEY |
(auto-generated) | LiveKit API key |
LIVEKIT_API_SECRET |
(auto-generated) | LiveKit API secret |
LIVEKIT_RECORDING_ENABLED |
true |
Enable session recording |
LIVEKIT_RECORDING_BUCKET |
— | S3/MinIO bucket for recordings |
LIVEKIT_EGRESS_RTMP_URL |
— | RTMP URL for live streaming egress |
Ports
| Port | Purpose |
|---|---|
| 3107 | LiveKit management API |
| 7880 | LiveKit server WebRTC |
| 7881 | LiveKit server TCP fallback |
| 7882/UDP | LiveKit TURN server |
Database Tables
6 tables added to your Postgres database:
np_livekit_rooms, room definitions and settingsnp_livekit_participants, participant session recordsnp_livekit_recordings, recording archivesnp_livekit_egress, egress stream configurationsnp_livekit_quality_metrics, per-session quality datanp_livekit_tokens, issued participant tokens
Nginx Routes
| Route | Target |
|---|---|
/livekit/ |
LiveKit management API |
/rtc/ |
LiveKit WebRTC proxy |