Configure a FreePBX v13 PJSIP Trunk
What Is FreePBX - Intro
FreePBX is a web-based open source GUI (graphical user interface) that controls and manages Asterisk (PBX), an open source communication server. FreePBX is licensed under the GNU General Public License (GPL), an open source license. FreePBX can be installed manually or as part of the pre-configured FreePBX Distro that includes the system OS, Asterisk, FreePBX GUI and assorted dependencies.
You'll need to have created an Credential based connection on your Telnyx Mission Control Portal account, assigned this connection to a DID and outbound profile in order to make and receive calls.
If you haven't set up a Telnyx portal account before, read our guide that'll take you through the process from start to finish in just a few minutes!
Let's get started!
- Download - FreePBX v13 is available to download from here.
- Installation - You can view the installation guide here.
- Configure Your Telnyx Mission Control Portal
Once you've configured your Telnyx account, you can now proceed to setup FreePBX V13 (PJSIP) following the guide below.
You are now all set on the Mission Control Portal side and are ready to configure your Telnyx trunk within your FreePBX V13 system.
Once you load the ISO onto your server or virtual machine, you'll have a few options to select for installation. We'll be doing a full install via asterisk 13.
- Confirm your appropriate network settings.
- Confirm your root password.
- Wait for all the necessary packages to be installed.
- More modules will be updated after successful internet tests.
- Enter root and the password you created from step 2.
- You'll now be provided with the URL you need to use in order to access the FreePBX web interface.
The default behavior of FreePBX version 13 is to use chan_pjsip for endpoints and trunks.
Selection of either chan_pjsip or can_sip from within your distribution can be found in the Admin Web tool under Settings -> Advanced Settings ->Dialplan and Operational -> SIP Channel Driver.
- To configure FreePBX to work with Telnyx SIP Trunking service, you should make configuration changes in 3 areas:
- Connectivity --> Trunks
- Connectivity --> Outbound Routes
- Connectivity --> Inbound Routes
Each of these is configured using the Admin Web tool provided by FreePBX.
- On FreePBX, go to Connectivity -> Trunks page
- Click on + Add Trunk → select Add SIP (chan_pjsip) Trunk.
When adding the new trunk, many settings are available, and most have defaults already configured.
To configure a Telnyx SIP Trunking account, make modifications to the following options:
- Trunk Name: Telnyx_userAuth
- Outbound CallerID: your_Telnyx_number
- CID Options: Allow Any CID
Dialed Number Manipulation Rules:
This entire section can be left at defaults or You can enter the Dial patterns Wizards.
- Select the "pjsip Settings" tab and edit the settings under the "General" sub-tab.
- Username : Enter the user name which you have created in the connections tab on Telnyx Portal
- Secret : The "Secret" is the password for your trunk found under the connection → "show password" link in your Telnyx portal
- Authentication : Outbound
- Registration : Send
- Language Code : English
- SIP Server : Sip.telnyx.com
- SIP Server Port : 5060
- Context : from-pstn
- Transport : 0.0.0.0-udp
Select the "Advanced" sub-tab under the "pjsip Settings" tab. Look at the image below.
You must edit the "From Domain" field to have “sip.telnyx.com”
Select the "Codecs" sub-tab under the "pjsip Settings" tab. Here you should select:
- ulaw, alaw, gsm, g722, g729, Opus
All other boxes should be unchecked. Because Telnyx supports the following codecs:
- G.711U (PCMU)
- G.711A (PCMA)
- Opus (supported for IB and OB calls, for IB calls though it's only allowed when using TLS or TCP transport)
After doing the above, please click on submit and apply config.
Now we need to configure “Outbound Routes”.
Make your way to Connectivity -> Outbound Routes.
Select "Connectivity" then "Outbound Routes." To create a new "Outbound Route," you must first enter a distinctive "Route Name." Then select the trunk you just created as the top route in "Trunk Sequence for Matched Routes."
- Select the "Dial Patterns" tab. Enter dial patterns exactly like the image below. They will allow for you to dial 10 Digits (U.S. Calling), 11 Digits (North American Calling). After entering this info, and clicking "Submit" then "Apply Config".
Make your way to Connectivity -> Inbound Routes.
To direct calls from sip.telnyx.com to an extension you must create an inbound route.
To start select "Inbound Routes" from the "Connectivity" menu on your FreePBX interface.
The image below demonstrates an inbound route that will send ANY call to a certain extension. To direct a specific number to a specific extension you would create a route and set the "DID Number" field to your 11 digit DID with sip.telnyx.com (for instance : 12172031700).
- In the Above screen shot, 1010 is the test extension created on the FreePBX.
That's it, you've now completed the configuration of FreePBX PJSIP V13 Credentials Trunk and can now make and receive calls by using Telnyx as your SIP provider!
Review our getting started guide to make sure your Telnyx Mission Control Portal account is setup correctly.
Checkout FreePBX's help section for extra support.
Need more help configuring your FreePBX PJSIP v13 Credentials Trunk? Click the Live Chat icon in the lower right hand corner of your Mission Control Portal and start a chat.