Docker-Einrichtung

Selu läuft als Gruppe von Docker-Containern. Dadurch kannst du es auf jedem System mit Docker zuverlässig betreiben.

Architekturüberblick

Eine Selu-Installation besteht aus dem Hauptserver und bedarfsweise gestarteten Agent-Containern:

selu

Der zentrale Server. Er übernimmt Dashboard, Nachrichten-Routing, lokale SQLite-Daten und Orchestrierung.

Agent-Container

Jeder installierte Agent läuft in einem eigenen Container. Diese Container werden automatisch erstellt, wenn du Agenten aus dem Marketplace installierst.

Alle Container kommunizieren über ein internes Docker-Netzwerk. Agent-Container verbinden sich per gRPC mit dem Server.

Voraussetzungen

• Docker Version 24 oder neuer
• Docker Compose Version 2.20 oder neuer
• Mindestens 2 GB RAM (mehr bei vielen Agenten oder lokalem Ollama)
• Linux, macOS oder Windows

Schnellstart

1. Erstelle ein Verzeichnis für Selu:

mkdir selu && cd selu

2. Starte den Installer:

bash <(curl -fsSL https://selu.bot/install.sh)

3. Oder nicht-interaktiv mit gewünschtem Kanal:

bash <(curl -fsSL https://selu.bot/install.sh) --yes --channel stable

Öffne danach http://localhost:3000 im Browser.

Docker-Compose-Datei

Die Standard-docker-compose.yml sieht so aus:

services:
  selu:
    image: ghcr.io/selu-bot/selu:${SELU_IMAGE_TAG:-stable}
    ports:
      - "${SELU__SERVER__PORT:-3000}:${SELU__SERVER__PORT:-3000}"
    environment:
      - SELU__ENCRYPTION_KEY=${SELU__ENCRYPTION_KEY}
      - SELU__SERVER__HOST=0.0.0.0
      - SELU__SERVER__PORT=${SELU__SERVER__PORT:-3000}
      - SELU__DATABASE__URL=sqlite:///app/data/selu.db?mode=rwc
      - SELU__MARKETPLACE_URL=https://selu.bot/api/marketplace/agents
      - SELU__INSTALLED_AGENTS_DIR=/app/installed_agents
      - SELU__RELEASE_METADATA_URL=https://selu.bot/api/releases/selu
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./data:/app/data
      - ./installed_agents:/app/installed_agents

Hinweis

Der Docker-Socket-Mount (/var/run/docker.sock) ist nötig, damit Selu Agent-Container verwalten kann.

Updates und Rollback

• Öffne System Updates in der Selu-Oberfläche.
• Wähle einen Kanal (stable, dev, nightly).
• Klicke auf Jetzt prüfen und Jetzt aktualisieren oder aktiviere Auto-Update.
• Falls ein Release die Health Checks nicht besteht, nutze Rollback.

Selu prüft vor dem Update Release-Digests über https://selu.bot/api/releases/selu. Updates werden durch den selu-updater-Sidecar-Container ausgeführt. Der Sidecar aktualisiert sich standardmäßig nicht im selben Lauf, sondern erst im nächsten Update-Zyklus.

Deployment absichern

• SELU__ENCRYPTION_KEY geheim halten. Dieser Schlüssel schützt gespeicherte Zugangsdaten.
• Port 3000 nicht direkt ins Internet stellen. Nutze einen Reverse Proxy (z. B. Nginx oder Caddy) mit HTTPS.
• Volumes regelmäßig sichern, besonders ./data mit Datenbank und Laufzeitstatus.
• Zugriff auf den Docker-Socket begrenzen, wenn das System von mehreren Diensten genutzt wird.

Alle Konfigurationsoptionen findest du unter Umgebungsvariablen.