Troubleshooting

Build failures

Install TypeScript globally or run npm install --include=dev in web/.

go mod tidy
go build ./...

Ensure PostgreSQL is running and .env has correct credentials:

docker compose -f docker/compose.yml logs postgres

Check Caddyfile includes the WebSocket upgrade headers:

handle /ws {
    reverse_proxy app:8080 {
        header_up Connection {>Connection}
        header_up Upgrade {>Upgrade}
    }
}

Verify LiveKit and coturn containers are running
Ensure UDP ports 7882, 3478, 50000-50100, and 10000-20000 are exposed
Check browser console for WebRTC ICE failures
Verify LIVEKIT_API_KEY and LIVEKIT_API_SECRET match in both LiveKit and coturn