.env.example
Set these on your host before deploying. Each platform has an “Environment Variables” section in the deploy flow.
SOVEREIGN_BOT_TOKEN
secret
── Telegram ──────────────────────────────────────────────────────────────────
SOVEREIGN_ALLOWED_USERS
SOVEREIGN_VAULT_PASS
── Security ───────────────────────────────────────────────────────────────────
SOVEREIGN_LLM_PROVIDER
── LLM Provider ─────────────────────────────────────────────────────────────── Option A: Local Ollama (default — free, private)
SOVEREIGN_OLLAMA_URL
SOVEREIGN_MODEL
SOVEREIGN_DATABASE_URL
secret
── Database ─────────────────────────────────────────────────────────────────── Unix socket peer auth (default — no password needed locally)
SOVEREIGN_SESSION_ID
── Session / Logging ──────────────────────────────────────────────────────────
SOVEREIGN_LOG_LEVEL
SOVEREIGN_TTS_BACKEND
── Part 9: Voice ─────────────────────────────────────────────────────── TTS backend: "edge" (free, cloud) or "piper" (local ONNX model)
SOVEREIGN_TTS_VOICE
Edge TTS voice name (see: edge-tts --list-voices)
brew install flyctl && fly launch --from https://github.com/novasplace/sovereignbot
curl -L https://fly.io/install.sh | sh && fly launch --from https://github.com/novasplace/sovereignbot
iwr https://fly.io/install.ps1 -useb | iex; fly launch --from https://github.com/novasplace/sovereignbot