Guides

Step-by-step tutorials and in-depth guides for Asterisk configuration, deployment, and administration.

ari astdb audio beginner cdr compliance configuration contexts database dialplan email extensions getting-started iax2 imported logging mixmonitor moh mpg123 multi-site music-on-hold mwi mysql nat patterns peering performance pjsip postgresql python recording rest-api routing sip sqlite stasis streaming trunking voicemail websocket
PJSIP Configuration from Scratch

Complete PJSIP setup: transports, endpoints, template inheritance, SIP trunk registration, outbound dialing, and troubleshooting NAT and registration problems.

Featured Getting Started Asterisk 18+ sip pjsip configuration getting-started
Call Detail Records (CDR) - Storage Backend Guide

Configure CDR storage with SQLite, MySQL/MariaDB, or PostgreSQL. Covers cdr.conf, database schemas, module setup, and useful reporting queries for each backend.

Featured Reporting logging cdr mysql database
Asterisk Dial Patterns: The Complete Guide

How Asterisk matches dialed numbers to dialplan extensions. Pattern syntax, wildcard characters, specificity rules for overlapping patterns, real-world examples for NANP, international, and internal d...

Getting Started dialplan routing extensions patterns
Where to Find Hold Music (and How to Stream It Live)

Royalty-free music sources for Asterisk MOH, how to convert audio for native playback, and streaming live internet radio through mpg123.

Getting Started configuration audio moh music-on-hold
IAX2 Trunk Between Two Asterisk Servers

Connect two Asterisk systems over IAX2 so they can dial each other's extensions. Covers iax.conf on both sides, authentication, trunking, and dialplan routing.

Getting Started Asterisk 18+ trunking iax2 peering multi-site
Music on Hold with Native Formats

Set up music on hold using pre-converted audio files instead of live MP3 decoding. Covers musiconhold.conf, format conversion, multiple music classes, and avoiding transcoding overhead.

Getting Started Asterisk 18+ configuration audio music-on-hold performance
Selective Call Recording

Record calls on specific extensions using AstDB flags. Toggle recording from the CLI or a feature code without editing the dialplan. Includes file organization and compression.

Getting Started Asterisk 18+ astdb recording mixmonitor compliance
Getting Started with ARI

Use the Asterisk REST Interface to control calls from external programs. Covers HTTP server setup, WebSocket events, REST commands, Python example, and channel bridging.

Getting Started Asterisk 18+ ari rest-api stasis python
Setting Up Voicemail in Asterisk

Configure voicemail from scratch: voicemail.conf mailboxes, dialplan integration with busy and unavailable greetings, MWI indicators, email notifications, and common troubleshooting.

Getting Started Asterisk 18+ pjsip voicemail email mwi
Dialplan Contexts, Extensions, and Priorities

How Asterisk dialplan structure works. Contexts isolate call flows, extensions match dialed numbers with pattern matching, and priorities run applications in sequence.

Getting Started Asterisk 18+ dialplan beginner contexts getting-started
Your First Working Asterisk Dialplan

Get from a blank config to phones calling each other. Covers PJSIP endpoint registration, a minimal dialplan, internal extension dialing, and debugging common problems.

Getting Started Asterisk 18+ pjsip dialplan beginner getting-started