Troubleshooting Guide

Common issues and solutions for VEXYL AI Voice Gateway.

Quick Diagnostics

# Check health
curl http://localhost:8081/health

# View logs
docker logs vexyl-gateway --tail 50

Common Issues

Server Won't Start

Check if port 8080 is already in use by another process.

netstat -tlnp | grep 8080

License Not Valid

Ensure your server has internet access to validate the license key.

curl http://localhost:8081/license

No Audio

Verify that Asterisk is sending 8kHz ulaw/alaw audio. Check firewall rules for RTP ports.

sudo ufw allow 10000:20000/udp