I connected a LiveKit agent with a sip trunk to a ...
# ask-aid
damp-apartment-38475
07/28/2025, 10:15 AMI connected a LiveKit agent with a sip trunk to a telephony system. I am facing random "media timeout" issues and I can't figure them out
t
tall-airline-16756
07/28/2025, 10:15 AMThanks for reaching out, Abdallah. I'm an AI assistant and I'm here to help. Give me a moment while I research this topic.
tall-airline-16756
07/28/2025, 10:17 AMTo address the random "media timeout" issues you're experiencing with your SIP trunk integration, here are some systematic troubleshooting steps:
1. Network Connectivity Diagnostics
• Ensure UDP ports 10000-20000 are open for RTP media.
• Verify SIP signaling ports (5060/5061) are accessible.
• Check for firewall or NAT issues, such as blocked UDP traffic or improper NAT traversal settings.
• Ensure DTLS traffic is not being filtered by firewalls.
2. Configuration Review
• Review and adjust media timeout settings in your configuration:
• Enable jitter buffer for audio stability in networks with variable latency.
• Ensure media encryption settings are compatible between LiveKit and your SIP trunk.
3. SIP Trunk Specific Diagnostics
• Verify SIP trunk credentials and authentication methods.
• Check for proper SIP response codes and call flow completion.
• Monitor for any SIP protocol failures that might affect media setup.
4. Monitoring and Logging
• Monitor RTP packet flow and timing to check for packet loss or irregular intervals.
• Track media timeout occurrences in relation to call states (e.g., dialing, ringing, active).
• Enable detailed logging for media and SIP components to identify patterns.
5. Environmental Factors
• Test during different times of day to identify network congestion patterns.
• Evaluate network stability and consistency.
• Check server resource utilization during timeout events and monitor concurrent call volumes.
Immediate Actions
• Temporarily increase timeout values to determine if timing is the primary issue.
• Enable detailed logging for media and SIP components.
• Test with a simplified configuration (e.g., disable encryption).
• Use LiveKit's connection tester tools to validate connectivity.
These steps should help identify and resolve the root cause of the media timeout issues. If the problem persists after following these recommendations, further investigation may be required.
Sources: livekit/livekit_models.pb.go | pkg/sip/outbound.go | SIP Integration | livekit/livekit_composite | DeepWiki | Firewall Tips
d
damp-apartment-38475
07/28/2025, 10:24 AMI can't do most of the things here since I used LiveKit Cloud
t
tall-airline-16756
07/28/2025, 10:25 AMHey there! Having trouble with media timeouts on LiveKit Cloud? No worries, I've got some friendly tips to help you troubleshoot.
1. Network Connectivity
• Let's make sure your network is playing nice. If you're behind a firewall, you might want to set up TURN relay mode to keep things smooth.
• Do a quick check and whitelist
*.turn.livekit.cloudMEDIA_FAILURE7 Views