Zum Inhalt

Installation

Overseer läuft als Docker-Compose-Stack auf einem Linux-Server. Die Installation dauert ca. 5–10 Minuten.

Voraussetzungen

Was Mindestens Empfohlen
Betriebssystem Linux (Debian 12+, Ubuntu 22.04+, RHEL 9+) Debian 13
RAM 2 GB 4 GB ab ~50 Hosts
CPU 1 Core 2 Cores ab ~50 Hosts
Disk 10 GB 50 GB SSD (für Log-Retention)
Software Docker 24+ und Docker Compose 2.20+ aktuelle Versionen
Netzwerk Outbound HTTPS 443 + Domain mit DNS auf den Server

Faustregel

Der Stack braucht idle ~1 GB RAM. Pro 100 zusätzliche Hosts ungefähr +500 MB und ein zusätzlicher CPU-Core. Logs und lange Retention-Zeiten erhöhen vor allem den Disk-Bedarf.

Warum eine Domain?

Mit eigener Domain bekommt der Setup-Wizard automatisch ein Let's-Encrypt-Zertifikat. Ohne Domain läuft Overseer mit Self-Signed-Cert, was im Browser eine Warnung erzeugt.

Schritt 1 — Setup-Script ausführen

Auf deinem Server als root oder mit sudo:

bash curl -sSL https://licence.dailycrust.it/api/v1/install | bash

Das Script führt dich interaktiv durch:

  1. Installiert Docker und openssl, falls nicht vorhanden
  2. Fragt nach Registry-Credentials — bei Community einfach mit Enter überspringen
  3. Lädt docker-compose.prod.yml und .env.example vom Lizenzportal
  4. Fragt nach Base URL (z.B. https://monitoring.example.com oder https://192.168.1.50)
  5. Fragt optional nach einem Lizenzschlüssel (leer lassen für Community)
  6. Generiert Secrets (DB-Passwort, JWT-Key, Field-Encryption-Key) und zeigt den Encryption-Key — diesen unbedingt extern sichern!
  7. Startet alle Container

Field-Encryption-Key sichern

Der FIELD_ENCRYPTION_KEY schützt verschlüsselte Felder (SNMP-Communities, Passwörter). Geht dieser Key verloren, sind die verschlüsselten Daten dauerhaft unwiederbringlich. Sofort an einen sicheren Ort kopieren (Passwort-Manager, externes Backup).

Schritt 2 — Setup-Wizard im Browser öffnen

Nach dem Start öffne im Browser:

https://deine-domain.tld/setup

(oder die IP, falls ohne Domain)

Der Wizard führt dich durch:

  1. Willkommen — Sprachauswahl
  2. Admin-Account — erster Super-Admin-User (Email + Passwort)
  3. Tenant — Namen deines ersten Mandanten
  4. SMTP (optional) — für E-Mail-Alerts
  5. Fertig — Login und Dashboard öffnen

Schritt 3 — Ersten Host hinzufügen

Sobald du eingeloggt bist:

  1. Im Menü links auf Hosts → Neu
  2. Host-Typ wählen (Linux Server, Windows Server, Switch, ...)
  3. IP-Adresse oder Hostname eintragen
  4. Bei Linux/Windows: Agent auswählen, Token kopieren
  5. Auf der Zielmaschine ausführen:

bash wget -qO- https://deine-domain.tld/agent/install.sh | bash -s -- TOKEN https://deine-domain.tld

Den Installer overseer-agent-setup.exe von der Downloads-Seite herunterladen und mit Server-URL + Token starten.

Der Agent meldet sich nach 30 Sekunden im Dashboard.

Updates

Updates kommen über die GUI:

  1. Admin → Updates
  2. Nach Updates suchen
  3. Jetzt updaten

Das System macht automatisch ein Backup, lädt die neue Version, führt Migrations aus, startet die Container neu. Bei Fehlern rollt es automatisch zurück.

Niemals manuell docker compose pull ausführen

Updates immer über die GUI laufen lassen — der Updater kümmert sich um Backup, Migrations und Rollback. Manuelle Updates können den Stack in einen inkonsistenten Zustand bringen.

Backups

Standard-Backups (PostgreSQL Dump) liegen in:

/opt/overseer/backups/

Sie werden täglich um 03:00 Uhr erstellt und 30 Tage aufbewahrt. Konfigurierbar unter Admin → Backup.

Probleme?

  • Container starten nicht → docker compose logs api auf dem Server
  • Wizard nicht erreichbar → DNS-Eintrag prüfen, curl -I https://deine-domain.tld/setup
  • Lizenz wird nicht akzeptiert → Schlüssel komplett kopiert? Server-Zeit korrekt? (NTP)
  • Agent verbindet nicht → Outbound-443-Firewall? Token korrekt? journalctl -u overseer-agent -f

Bei hartnäckigen Problemen: GitHub Issue öffnen oder kontakt@overseer.dailycrust.it.