Docker Guard Hilfe

Fehlerbehebung
EN DE
Diagnose
Fehlerbehebung

App zeigt „Nicht verbunden"

  1. Erreichbarkeit prüfen: curl http://<host-ip>:18080/health
  2. Sicherstellen, dass das iPhone im selben Netz wie der Docker-Host ist (oder per VPN).
  3. URL in Einstellungen → Agent-Verbindung mit Schema und Port eintragen (z. B. http://192.168.1.20:18080).

App meldet „Ungültiger API-Schlüssel"

Der X-API-Key-Header passt nicht zum DOCKERGUARD_API_KEY des Agents. Wert erneut einfügen und Verbinden antippen.

Container-Aktionen schlagen fehl

  • Der Docker-Socket muss im Agent schreibbar gemountet sein (das :ro entfernen).
  • Das Control Pack muss in der iOS-App aktiv sein.
  • Agent-Logs prüfen: docker logs docker-guard-agent

Keine Hintergrund-Benachrichtigungen

  • iOS begrenzt Background-Fetches. Das Intervall in der App ist nur ein Vorschlag — der tatsächliche Zeitplan liegt bei iOS.
  • Benachrichtigungen müssen in iOS-Einstellungen → Docker Guard erlaubt sein.
  • Force-Quit der App deaktiviert Background-Fetches.

Lokaler Netzwerkzugriff

iOS fragt beim ersten Verbindungsversuch zum Agent nach Erlaubnis für lokales Netzwerk. Wurde „Nicht erlauben" gewählt, lässt sich das unter iOS-Einstellungen → Docker Guard → Lokales Netzwerk zurücksetzen.