Zum Inhalt

Setup-Script

Das automatische Setup-Script ist der empfohlene Weg, wenn der Server Internetzugang hat.

Was es macht

  1. Prüft Docker und Docker Compose, installiert sie bei Bedarf
  2. Lädt docker-compose.prod.yml und .env.example vom Lizenzportal
  3. Fragt nach Registry-Credentials (Community: leer lassen)
  4. Fragt nach Base URL (Domain mit https:// oder IP)
  5. Fragt optional nach einem Lizenzschlüssel
  6. Generiert alle Secrets (DB-Passwort, JWT-Key, Field-Encryption-Key, Redis-Passwort)
  7. Schreibt die .env
  8. Pullt alle Images
  9. Startet den Stack

Ausführen

Als root oder mit sudo:

curl -sSL https://license.vesana.org/api/v1/install -o /tmp/setup.sh
sudo bash /tmp/setup.sh

Falls curl fehlt:

sudo apt update && sudo apt install -y curl

Was passiert während des Laufs

[1/7] Voraussetzungen prüfen ...
      ✓ Docker 27.3.1
      ✓ Docker Compose 2.29.2
[2/7] Verzeichnisse anlegen ...
      ✓ /opt/vesana
[3/7] Compose-Datei laden ...
[4/7] Eingaben:
      Base URL: https://monitoring.example.com
      Lizenzschlüssel (Enter = Community): _
[5/7] Secrets generieren ...
      FIELD_ENCRYPTION_KEY: dQw4w9WgXcQ-tH...
      ⚠ JETZT extern sichern (Passwort-Manager, externes Backup)!
[6/7] Images pullen ...
[7/7] Container starten ...
      ✓ vesana-api ... healthy
      ✓ vesana-receiver ... healthy
      ✓ vesana-worker-0 ... running
      ✓ vesana-frontend ... healthy
      → Browser öffnen: https://monitoring.example.com/setup

FIELD_ENCRYPTION_KEY sichern

Schlüsselverlust = Datenverlust

Der FIELD_ENCRYPTION_KEY schützt verschlüsselte Felder (z. B. SNMP-Communities). Geht der Schlüssel verloren, sind diese Daten dauerhaft unwiederbringlich.

Sofort nach der Installation:

  1. Schlüssel aus dem Setup-Output kopieren
  2. In einem Passwort-Manager hinterlegen (Bitwarden, 1Password, KeePass)
  3. Zusätzlich offline ausdrucken oder in einem getrennten Backup ablegen
  4. Nicht ins gleiche Volume legen wie die Datenbank-Backups

Nach Abschluss des Setups: weiter mit dem Setup-Wizard im Browser.

Re-Run

Das Setup-Script ist nicht für mehrfaches Ausführen gedacht. Wenn du den Stack neu konfigurieren willst:

  • Für .env-Änderungen: Datei direkt bearbeiten, dann docker compose -f /opt/vesana/docker-compose.prod.yml up -d
  • Für eine komplette Neuinstallation: docker compose -f /opt/vesana/docker-compose.prod.yml down -v (löscht alle Daten!), dann Setup neu

Anschluss