Troubleshooting

Common issues during first deploys and proxy-based setups.

Common issues

Blank logs or no live updates

Confirm the Docker socket is mounted, containers are running, and your proxy forwards WebSocket Upgrade headers.

Permission denied on actions

In auth mode, confirm both ALLOW_* and can_* flags. In no-auth mode, confirm the ALLOW_* env var is true.

API blocked from browser or curl

With CLIENT_ACCESS=strict, browser clients need X-DockLog-Client: web and an allowed Origin. Add ALLOWED_ORIGINS or use CLIENT_ACCESS=off for local debugging only.

Login fails behind a reverse proxy

Set TRUST_PROXY=true, list your HTTPS origin in ALLOWED_ORIGINS, and confirm the proxy forwards Host and X-Forwarded-Proto.

Edit or suggest changes on GitHub.