Asterisk troubleshooting

Start from the failed boundary, not a random config change.

Choose the symptom. The decision guide returns likely causes and the smallest commands needed to prove or reject them before you restart Asterisk.

before editingCapture the SIP dialog, negotiated SDP, RTP direction, and Asterisk logs from one failed call.
Open config generator
diagnostic path

One-way or no audio

likely causes
  1. Wrong external media address in SDP
  2. RTP firewall range does not match rtp.conf
  3. Carrier sends media from an unallowed network
  4. Direct media bypasses Asterisk
checks in order
  1. asterisk -rx "rtp set debug on"
  2. asterisk -rx "pjsip set logger on"
  3. Confirm external_media_address and external_signaling_address
  4. Verify the same UDP range at host firewall and upstream NAT

Use the configuration guide when the symptom crosses boundaries

PJSIP, dialplan, ARI, RTP, NAT, external media, WebSocket support, and security are documented together in the Asterisk deployment guide.

deployment guideAsterisk for Voice AIOpen guide →