references/tunnel/gotchas.md
Tunnel Troubleshooting
Capture the tunnel status, failing route, management mode, and cloudflared logs before changing settings.
| Task | Documentation | | --- | --- | | Tunnel fails to connect or reports an error | Troubleshooting | | Tunnel is healthy but an HTTPS application fails or redirects | HTTPS origins | | Inspect connection health and application diagnostics | Monitoring | | Check local configuration and rule matching | Configuration file | | Connections behave unexpectedly after token rotation | Tunnel tokens | | Check replica capacity or firewall requirements | Configuration | | Update an existing installation | Update cloudflared |
Separate tunnel health from origin availability. Check the service address, protocol, and certificate before relaxing verification. Scope operational changes to the intended tunnel and replicas; follow the documented rotation and upgrade sequence instead of stopping every cloudflared process on a host. See networking.md for connectivity checks.