Umgebungsvariablen

Die gesamte Selu-Konfiguration erfolgt über Umgebungsvariablen, die normalerweise in deiner .env-Datei neben docker-compose.yml gesetzt werden. Diese Seite listet alle verfügbaren Variablen auf.

Erforderliche Variablen

Diese müssen gesetzt sein, damit Selu startet:

Variable	Beschreibung
`SELU_SECRET_KEY`	Master-Verschlüsselungsschlüssel für Zugangsdaten. Verwende eine zufällige Zeichenkette mit mindestens 32 Zeichen.
`POSTGRES_PASSWORD`	Passwort für die PostgreSQL-Datenbank.

Server-Konfiguration

Variable	Beschreibung	Standard
`SELU_PORT`	Port, auf dem das Selu-Dashboard lauscht	`3000`
`SELU_HOST`	Hostname oder IP zum Binden	`0.0.0.0`
`SELU__EXTERNAL_URL`	Öffentliche URL deiner Selu-Instanz (für Webhooks verwendet)	`http://localhost:3000`
`SELU__BASE_PATH`	URL-Pfad-Präfix für Reverse-Proxy-Deployments (z.B. `/selu`)	—
`SELU_LOG_LEVEL`	Logging-Ausführlichkeit: `debug`, `info`, `warn`, `error`	`info`

System-Updates

Konfiguriere die integrierte System-Update-Funktionalität:

Variable	Beschreibung	Standard
`SELU_RELEASE_CHANNEL`	Standard-Release-Kanal: `stable`, `dev`, `nightly`	`stable`
`SELU__RELEASE_METADATA_URL`	Update-Metadaten-Endpunkt-URL	`https://selu.bot/api/releases/selu`
`SELU__COMPOSE_FILE`	Pfad zur Docker-Compose-Datei für Updates	`./docker-compose.yml`
`SELU__COMPOSE_SERVICE`	Docker-Compose-Service-Name für Selu-Container	`selu`
`SELU__COMPOSE_ENV_FILE`	Pfad zur Umgebungsdatei, die bei Kanaländerungen aktualisiert wird	`./.env`

Datenbank

Variable	Beschreibung	Standard
`DATABASE_URL`	Vollständige PostgreSQL-Verbindungszeichenkette (überschreibt individuelle Vars)	—
`POSTGRES_HOST`	Datenbank-Hostname	`selu-db`
`POSTGRES_PORT`	Datenbank-Port	`5432`
`POSTGRES_DB`	Datenbankname	`selu`
`POSTGRES_USER`	Datenbank-Benutzername	`postgres`
`POSTGRES_PASSWORD`	Datenbank-Passwort	—

Kanäle

Variable	Beschreibung	Standard
`TELEGRAM_BOT_TOKEN`	Telegram-Bot-Token (Alternative zur Einstellung im Dashboard)	—
`BLUEBUBBLES_URL`	BlueBubbles-Server-URL für iMessage	—
`BLUEBUBBLES_PASSWORD`	BlueBubbles-Server-Passwort	—

LLM-Anbieter

Variable	Beschreibung	Standard
`ANTHROPIC_API_KEY`	Anthropic-API-Schlüssel	—
`OPENAI_API_KEY`	OpenAI-API-Schlüssel	—
`AWS_ACCESS_KEY_ID`	AWS-Zugriffsschlüssel für Bedrock	—
`AWS_SECRET_ACCESS_KEY`	AWS-Geheimschlüssel für Bedrock	—
`AWS_REGION`	AWS-Region für Bedrock	`us-east-1`
`OLLAMA_BASE_URL`	Ollama-Server-URL	`http://host.docker.internal:11434`

Agenten

Variable	Beschreibung	Standard
`SELU_AGENT_NETWORK`	Docker-Netzwerkname für Agent-Container	`selu-agents`
`SELU_AGENT_TIMEOUT`	Standard-gRPC-Timeout für Agent-Aufrufe (Sekunden)	`30`
`SELU_AGENT_MAX_MEMORY`	Speicherlimit pro Agent-Container	`512m`

Sitzung

Variable	Beschreibung	Standard
`SELU_SESSION_IDLE_TIMEOUT`	Leerlauf-Timeout bevor eine Sitzung abläuft (Minuten)	`30`
`SELU_SESSION_MAX_HISTORY`	Maximale Nachrichten im Sitzungskontext	`100`

Verwendung einer `.env`-Datei

Platziere deine .env-Datei im selben Verzeichnis wie docker-compose.yml. Docker Compose nimmt sie automatisch auf:

SELU_SECRET_KEY=a1b2c3d4e5f6...
POSTGRES_PASSWORD=mein-starkes-passwort
SELU__EXTERNAL_URL=https://selu.example.com
SELU_RELEASE_CHANNEL=stable
SELU_LOG_LEVEL=info

Du kannst Variablen auch direkt in der docker-compose.yml unter dem environment-Schlüssel setzen, aber die .env-Datei ist für die meisten Setups sauberer.

Variablen-Benennung

Selu verwendet doppelte Unterstriche (__) für verschachtelte Konfigurationsschlüssel. Zum Beispiel:

SELU__EXTERNAL_URL entspricht dem external_url-Feld in der Konfiguration
SELU__BASE_PATH entspricht dem base_path-Feld

Einzelne Unterstriche trennen Wörter innerhalb derselben Konfigurationsebene.