Probleme lösen
Häufige Probleme
Starte mit den Basis-Checks. Die meisten Probleme sind entweder Netzwerk (TrueNAS nicht erreichbar) oder TLS (Zertifikat hat sich geändert).
Agent Web UI nicht erreichbar
- Port-Mapping prüfen (Beispiel:
18080 → 8080).
- Prüfen, ob der Container läuft und nicht in einer Restart-Schleife hängt.
- Sicherstellen, dass der Browser die richtige Host/IP des Agents verwendet.
Pairing schlägt fehl
- Neuen Pairing-Code in der iOS App erzeugen (Codes sind bewusst kurz gültig).
- Sicherstellen, dass der Agent das Internet erreicht, um die Pairing-Konfiguration zu laden (falls euer Setup einen Push/Config-Server nutzt).
- Erneut versuchen und im Agent UI auf Fehlermeldungen achten.
Keine Alerts / Agent zeigt disconnected
- Prüfen, ob die TrueNAS-URL aus dem Netzwerk des Agents erreichbar ist.
- Wenn ein Hostname genutzt wird: testweise einen auflösbaren DNS-Namen oder eine IP-Adresse verwenden.
- Prüfen, ob der TrueNAS API-Key gültig ist.
Tipp: Hostnames, die am Laptop funktionieren, sind im Container nicht zwangsläufig auflösbar.
TLS Fehler / Pin-Mismatch
Wenn sich das TrueNAS-Zertifikat geändert hat, kann der Agent die Verbindung blockieren, weil der gespeicherte Fingerprint nicht mehr passt.
- Sicherstellen, dass du wirklich das richtige TrueNAS-System ansprichst (richtige IP/Host).
- Wenn das Zertifikat absichtlich geändert wurde: im Agent UI Zertifikat-Pin zurücksetzen.
- Danach neu verbinden, damit der Agent den neuen Fingerprint pinnen kann.
Sicherheit: Setze den Pin nicht zurück, wenn du nicht erklären kannst, warum sich das Zertifikat geändert hat.