Zum Hauptinhalt springen

Troubleshooting

Calls Not Appearing​

  • Verify the PBX CDR URL is correct (webcdrs://your-domain.com/cdr)
  • Check that the PBX server's IP is in the Vodia Analytics IP whitelist (Admin → IP Whitelist)
  • Check API logs: docker compose logs api --tail 100

Recordings Not Playing​

  • Ensure the recording format is set to Linear Stereo on the PBX
  • Check MinIO is running: docker compose ps minio
  • Check worker logs for upload errors: docker compose logs worker --tail 100

Transcription Not Working​

  • Transcription requires recordings to be present — check recordings first
  • Check worker logs: docker compose logs worker --tail 100
  • The worker container needs sufficient memory (2 GB minimum for whisper-base)
  • For silence-only recordings, the silence detection threshold may skip transcription (this is intentional)

AI Analysis Not Appearing​

  • Verify an OpenAI API key is configured in Admin or in the .env file
  • Check that auto-summarize is enabled for the tenant (AI Insights page toggle), or trigger analysis manually from the Call Detail Modal
  • Check worker logs for OpenAI API errors

HTTPS Certificate Issues​

  • Ensure the domain's DNS A record points to the server's IP
  • Caddy needs ports 80 and 443 open for the ACME challenge
  • Check Caddy logs: docker compose logs caddy --tail 50
  • For localhost mode, HTTPS is not used

Container Health​

Check all containers are running:

docker compose ps

All services should show Up (healthy) or Up. Restart a specific service:

docker compose restart api
docker compose restart worker

View logs for any service:

docker compose logs <service> --tail 200 -f