Doc
Doc

Global Configuration

The global configuration panel is used to manage VoceSpace system settings.

Global Configuration

Accessing Global Configuration

In the Dashboard home page action menu, click "Global Configuration" to open the configuration panel.

Configuration Items

Audio/Video Configuration

Setting Description Options
Codec Select video encoding format vp9 / vp8 / h264 / av1
Resolution Set video resolution 720p / 1080p / 4k
Max Bitrate Limit maximum video bitrate, affecting quality and bandwidth Numeric value, e.g., 3000000
Max Framerate Set maximum video framerate Numeric value, e.g., 30
Priority Transmission priority during network congestion high / medium / low

Configuration example:

1{
2  "codec": "vp9",
3  "resolution": "1080p",
4  "maxBitrate": 3000000,
5  "maxFramerate": 30,
6  "priority": "high"
7}

TURN Server Configuration

Setting Description
URLs TURN server address array
Username TURN server authentication username
Password TURN server authentication password

Configuration example:

1{
2  "livekit": {
3    "turn": {
4      "urls": ["turn:your-turn-server.com:3478"],
5      "username": "your-username",
6      "credential": "your-password"
7    }
8  }
9}

TURN servers are used to establish P2P connections in NAT/firewall environments.

AI Configuration

Setting Description Example Value
Enabled Whether to enable AI features true / false
API Key Access key for the AI service xxxx
API URL Interface URL of the AI service xxxx
Model AI model name in use qwen3-omni-flash
Max Tokens Maximum output length for AI analysis 4000

Configuration example:

1{
2  "ai": {
3    "enabled": true,
4    "apiKey": "xxxx",
5    "apiUrl": "xxxx",
6    "model": "qwen3-omni-flash",
7    "maxTokens": 4000
8  }
9}

Create Space Policy

Policy Config Value Description
All Users all Any user can create new spaces
Authenticated Only authenticated Only authenticated users can create new spaces
Whitelist Mode whitelist Only users in the whitelist can create new spaces
Disabled none Disable new space creation

Configuration example:

1{
2  "create_space": "all"
3}

Whitelist mode also requires configuring the user list:

1{
2  "create_space": "whitelist",
3  "whiteList": ["USER-han", "USER-EE", "USER-99"]
4}

Complete Configuration Example

1{
2  "livekit": {
3    "key": "your-api-key",
4    "secret": "your-api-secret",
5    "url": "wss://your.server.name",
6    "turn": { "credential": "", "username": "", "urls": [] }
7  },
8  "codec": "vp9",
9  "resolution": "1080p",
10  "maxBitrate": 3000000,
11  "maxFramerate": 30,
12  "priority": "high",
13  "redis": { "enabled": true, "host": "localhost", "port": 6379, "password": "vocespace", "db": 0 },
14  "s3": {
15    "accessKey": "your-access-key",
16    "secretKey": "your-secret-key",
17    "bucket": "your-bucket-name",
18    "region": "us-east-2"
19  },
20  "serverUrl": "your.server.name",
21  "hostToken": "your-host-token",
22  "license": "your-license-token",
23  "ai": {
24    "enabled": true,
25    "apiKey": "your-ai-api-key",
26    "apiUrl": "your-ai-api-url",
27    "model": "qwen3-omni-flash",
28    "maxTokens": 4000
29  },
30  "create_space": "all",
31  "whiteList": ["USER-han", "USER-EE", "USER-99"]
32}

Notes

  • Configuration changes take effect immediately without restarting the server
  • Keep your credentials secure and do not commit them to public code repositories
  • It is recommended to back up your current configuration before making changes
Table of Contents