Operations and Debugging
Diagnose common production and integration issues in OpenSana deployments.
Areas To Check First
- web app availability
- Convex deployment health
- Clerk configuration
- Resend configuration
- connected CLI session status
Common Symptoms
Users cannot sign in
Check Clerk keys, allowed domains, and whether the deployed URL matches your auth configuration.
Tasks load slowly or fail
Check the web deployment, Convex deployment status, and any backend error logs.
Threads do not execute
Check whether a compatible CLI profile is connected and whether the selected runtime is actually available on the connected machine.
Email links are wrong
Check NEXT_PUBLIC_APP_URL and any mismatched environment-specific sender configuration.
Debugging Strategy
Start from the user-visible symptom, then narrow the problem by subsystem:
- auth
- backend
- CLI connectivity
- runtime-specific execution