references/containers/gotchas.md
Containers troubleshooting
Use the current documentation to diagnose behavior instead of relying on copied timeout values, resource limits, or lifecycle recipes.
| Symptom or concern | Documentation to read | | --- | --- | | Startup timeout or unavailable port | Start and stop, Container properties, and first-deploy provisioning | | WebSocket forwarding fails | WebSocket example and request methods | | Background work stops on idle expiry | Activity renewal and idle expiry hook | | Scheduled callbacks do not run | Scheduling and alarm ownership | | Shutdown cleanup or filesystem data loss | Container shutdown and disk lifecycle | | Out-of-memory errors or resource exhaustion | FAQ and limits and instance types | | Instance count exceeded or unexpected request distribution | Wrangler configuration and scaling and routing | | Worker and container image versions differ after deployment | Deployment behavior and rollouts | | Local behavior differs from deployed behavior | Local development | | Logs, cold starts, or runtime availability questions | FAQ |