api/.env.example at main · SpawnDock/api · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
# --- Docker Compose / Caddy (read by Compose for interpolation and passed into containers) ---
# Caddy site address: :80 = HTTP on all interfaces; api.example.com = automatic HTTPS (DNS must point here).
PUBLIC_HOST=spawn-dock.w3voice.net

# --- Application (mcp-server, bot) ---
PORT=3000
RATE_LIMIT_RPS=10
QWEN_MODE=http
# container = run Qwen CLI inside Docker/Podman with knowledge/ mounted :ro (see docker/search/ and docker/qwen-search/README.md)
# Production sidecar: service `search` — http://search:8790
SEARCH_REST_API=true
SEARCH_API_URL=http://search:8790
QWEN_API_URL=http://search:8790
HF_TOKEN=
QWEN_TIMEOUT_MS=60000
QWEN_CODE_COMMAND=qwen
QWEN_CODE_AUTH_TYPE=qwen-oauth
QWEN_CONTAINER_IMAGE=spawndock/search:local
QWEN_CONTAINER_RUNTIME=docker
QWEN_CONTAINER_CORPUS_PATH=/corpus
QWEN_CONTAINER_MAX_STDOUT_BYTES=524288
QWEN_CONTAINER_MAX_STDERR_BYTES=65536
# Knowledge ranking in MCP (local-search) and search sidecar default: minisearch; use legacy for old heuristic only.
SEARCH_RANKER=minisearch
# search container: LRU cache of full JSON answers (same query+locale+corpus mtime). 0 = disabled.
SEARCH_RESPONSE_CACHE_MAX=64
# Bust cache after deploy without filesystem mtime change (optional string).
KNOWLEDGE_CACHE_REVISION=

# Usage dashboard (SQLite shared by search, mcp-server, bot). Set strong USAGE_ACTOR_SALT in production.
USAGE_DATABASE_PATH=/data/usage/events.sqlite
USAGE_ACTOR_SALT=replace-with-random-salt
# HTTP Basic for https://<host>/ops/usage/ (panel is proxied to mcp-server:3000).
OPS_USAGE_USER=
OPS_USAGE_PASSWORD=
# Public URL clients use (scheme + host, no trailing slash). With Caddy on 80/443 use http://your-host or https://your-host
PUBLIC_ORIGIN=https://spawn-dock.w3voice.net
# docker-compose.prod.yml mounts ./data/state → /app/.spawndock
STATE_FILE=/app/.spawndock/state.json
# Required when QWEN_MODE=container in Compose: host-absolute path to knowledge/ (e.g. /srv/spawndock-api/knowledge)
QWEN_KNOWLEDGE_HOST_PATH=
SPAWNDOCK_BOT_SECRET=replace-with-random-secret
# Shared MCP + dev-tunnel auth (optional in dev; set in production). Bot command /gettoken prints this value.
API_TOKEN=

TELEGRAM_BOT_TOKEN=
TELEGRAM_BOT_USERNAME=rustgpt_bot
TELEGRAM_MINI_APP_SHORT_NAME=tma
CONTROL_PLANE_URL=http://localhost:3000
BOT_POLL_TIMEOUT=25