Diagnostics¶
Run environment checks and get targeted guidance.
Checks
- API health and version
- Backend configuration
- Phaxio: API keys present, callback URL reachability hints, signature verification state
- Sinch: project ID and credentials present; base URL sanity
- SIP/Asterisk: AMI connectivity and authentication, Ghostscript availability for PDF→TIFF
- Public URL
PUBLIC_API_URLpresence and HTTPS enforcement if enabled- Storage
- Local path writable (dev)
- Optional S3 access checks (when diagnostics enabled)
- Security posture
- API key required, HTTPS enforced, audit logging enabled, file size limit
Actions
- “Restart API” (if allowed) to reinitialize backends after settings changes
- Copy suggested
.envsnippets for fixes
If something fails
- Follow the actionable link beside the check (e.g., Backends, Security)
- See Troubleshooting
Related docs
- Backends: Phaxio, Sinch, SIP/Asterisk
- Security: Authentication, HIPAA, OAuth/OIDC
- Deployment: Guide
- Third‑Party: Third-Party
Under the Hood¶
- Readiness probe:
GET /health/ready - Admin health:
GET /admin/health-status(aggregated checks for the console) - DB status:
GET /admin/db-status - Logs:
GET /admin/logsandGET /admin/logs/tail - Restart:
POST /admin/restart(requiresADMIN_ALLOW_RESTART=true)