DockTrace

FAQ & Troubleshooting

General questions

What do I need to use DockTrace?
A self-hosted Dozzle instance that your iPhone can reach — on your home network or via VPN. DockTrace is the companion; the server runs on your side.
Is DockTrace a replacement for the Dozzle web UI?
Deliberately not. DockTrace is not a 1:1 port but built for the mobile view: situational awareness, prioritized incidents, and favorites instead of a full admin console. For deep analysis, the browser on your desk remains the right tool.
What are incidents?
DockTrace groups similar error log lines into incidents via a fingerprint — with severity, occurrence count, and last seen. You instantly see whether something is a recurring problem instead of scrolling the same error message a hundred times.
Where are my credentials stored?
Exclusively on your device in the iOS Keychain. There is no cloud, no account, and no data transfer to the developer. Optionally, the app can be protected with Face ID.
Can I connect multiple servers?
Yes, any number of Dozzle instances. The container list can be filtered per server, and the overview shows all servers with their status side by side.

Troubleshooting

The connection to the server fails
Check the scheme and port of your Dozzle URL (http vs. https) and whether the instance is reachable from your current network — outside your home network you typically need VPN or a reverse proxy. If Dozzle authentication is enabled, the credentials must be set in the server settings.
No incidents show up
Incidents are built from recent error log lines. If your containers are running cleanly, the list stays empty — which is the ideal state. When in doubt, check the live logs to see whether any errors are coming in at all.
Live logs stay empty or disconnect
A reverse proxy in front of Dozzle must allow streaming connections (SSE/WebSocket) and must not cut them off after a short time. Check your proxy’s timeout and buffering settings.
Containers are missing or look outdated
Pull the list down to refresh and check the server status in the overview. If that doesn’t help, briefly switch servers back and forth or restart the app.

Go to Support →