Docker Guard Help

App shows "Disconnected"

1. Confirm the agent is reachable: curl http://<host-ip>:18080/health
2. Make sure your iPhone is on the same network as the Docker host (or that you reach it via VPN).
3. Verify the URL in Settings → Agent Connection includes the scheme and port (e.g. http://192.168.1.20:18080).

App returns "Invalid API key"

The X-API-Key header didn't match the agent's DOCKERGUARD_API_KEY. Re-paste the value from your generation command and tap Connect again.

Container actions fail

• The Docker socket must be mounted writable in the agent (remove the :ro suffix).
• The Control Pack must be active in the iOS app.
• Inspect the agent logs: docker logs docker-guard-agent

No background notifications

• iOS limits background fetch frequency. The poll interval in the app is a hint — actual schedule depends on iOS.
• Make sure notifications are allowed in iOS Settings → Docker Guard.
• Force-quitting the app disables background fetches.

Local network access

iOS may ask for permission to access devices on your local network the first time the app reaches the agent. If you tapped "Don't Allow", reset it under iOS Settings → Docker Guard → Local Network.