Skip to main content
FreePBX Trunk Settings With Telnyx

Learn how to configure a FreePBX V13 IP trunk with Telnyx. Get started today. HINT: It's easy.

C
Written by Customer Success
Updated over a week ago

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.

Note: We suggest using PJSIP as an upgrade from Chan_SIP, as Chan_SIP is outdated, and the majority of users are moving to PJSIP which provides a number of more future proof options, and is still actively being improved by the community. You can find out more about PJSIP here.

Additional documentation and resoruces:


Instructions for Configuring a FreePBX V15 IP Trunk

In this activity you will:

Pre-requisites

Video Walkthrough

Setting up your Telnyx SIP portal account so you can make and receive calls:

Note: Video walkthrough for FreePBX/Telnyx configuration coming soon. Check back as we update our docs.

1. Install your FreePBX V13

In this section, you'll go through the steps you need to follow to install FreePBX.

  1. 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.

    A page showing ISO installation using asterisk 13

  2. Confirm your network settings.

    Network setting confirmations page.

  3. Choose and confirm your root password.

    Root password confirmation page.

  4. Wait while your packages are installed.

    Package installation waiting page.

  5. Enter your root username and password.

    Localhost credentials input point.

  6. You'll now be provided with the URL you need to use in order to access the FreePBX web interface.

    The FreePBX Web Interface.

  7. Enter the IP address of the new PBX into your web browser. The first time you do so, you'll be asked to create the admin username and the admin password. That username and password will be used in the future to access the FreePBX configuration screen.

    Note: These passwords do not change the Root password! They are only used for access to the FreePBX web interface.

    Admin user credential creation interface.

  8. Once submitted you can log in to the admin panel with the username and password set up on the step above.


2. Configuring basic settings for your FreePBX

In this step, you'll configure your FreePBX V15 and connect it to Telnyx. To begin, notice that the main FreePBX screen will offer you four options:

The main FreePBX screen, with four options offering.
  • FreePBX Administration will allow you to configure your PBX. Use the admin username and admin password you configured in the step above to login. This section is what most people refer to as "FreePBX."

  • User Control Panel is where a user can log in to make web calls, set up their phone buttons, view voicemails, send and receive faxes, use SMS & XMPP messaging, view conferences, and more, depending on what you have enabled for the user.

  • Operator Panel is a screen that allows an operator to control calls

  • Get Support takes you to a web page about various official support options for FreePBX.

  1. Once you've created your account, you'll be brought to the dashboard. Select "FreePBX Administration" and enter your username and password.

  2. Follow the process to activate your FreePBX V15.

    FreePBX Administration dashboard.

  3. Select your default locales.

    Page to select default locales.

  4. You'll be presented with some firewall details and other suggestions. You are welcome to set this up based on your requirements.

  5. Once you're back at the dashboard, you'll see more detail.

    Admin dashboard with more administration details.


3. Configuring SIP settings for your FreePBX

At this point you can now work on confirming network settings and configuring your SIP trunks and extensions.

  1. Make your way to Settings -> Asterisk SIP Settings in order to confirm your network settings.

  2. You'll want to ensure you populate the external and local network addresses under General SIP Settings and Chan SIP Settings.

  3. Click Submit and then Apply Config.

    Asterisk SIP Settings for network settings confirmation.


4. Configure Extensions for your Free PBX

In this section, you'll configure all your PJSIP extensions.

  1. Make your way to Applications -> Extensions -> Add Extension -> Add New Chan SIP Extension. The Outbound CID is the number you purchased from your Telnyx Mission Control Portal. The extensions secret may need to be populated under the Other tab.

    Note that if you do not set an Outbound CID for your extension, you will need to enable this on your trunk.

    Note that this device uses CHAN_SIP technology listening on Port 5160 (UDP - this is a NON STANDARD port).

    New Chan SIP Extension Interface.

  2. Click Submit and Apply Config.

For testing purposes, you can now use your SIP client to register with FreePBX using the username, password/secret and local IP address of your FreePBX.


5. Configure a Trunk for your FreePBX

  1. Make your way to Connectivity -> Trunks -> Add Trunk -> Add New Chan SIP Trunk. You'll now be located in the General tab.

  2. Enter a Trunk name, your Outbound CID and the maximum channels you'd like for this trunk.

    General tab interface for FreePBX configuration.

    Note: If you choose not to set an Outbound CID on your trunk, then you must set an Outbound CID on each relevant extension. If you do not set a caller ID on either the trunk or each extension, then your calls will reach our SIP proxy without a valid caller ID. You may instead choose to enable a Caller ID Override in your SIP Connection’s Outbound Options from within the Telnyx Portal. Please review our caller ID number policy for accepted formats.

  3. Proceed to the Dialed Number Manipulation Rules tab. Depending on your use case, we've provided a simple dial pattern US numbers below.

    Dialed Number Manipulation Rules tab.

    For US numbers:

    1. prepend:1; match pattern: NXXNXXXXXX

    2. prepend: blank; match pattern: 1NXXNXXXXXX

    International:

    1. prepend: Country Dialing prefix; match pattern: NXXNXXXXXX

    2. prepend:blank; match pattern: (Country Dialing prefix)NXXNXXXXXX


6. Configure Outbound and Inbound Settings for your FreePBX

  1. Still in the Add Trunk configuration tool, Click on the SIP Settings tab and click on the Outgoing sub-tab. Make sure to specify:

    1. type: friend

    2. qualify: yes

    3. insecure: port,invite

    4. host: sip.telnyx.com

    5. fromdomain: sip.telnyx.com

    6. disallow: all

    7. allow: ulaw

      Add Trunk configuration interface.
  2. Now click on the Incoming sub-tab. Make sure to specify:

    1. type: friend

    2. insecure: port,invite

    3. host: sip.telnyx.com

    4. dtmfmode: rfc2833

    5. disallow: all

    6. allow: ulaw

      Incoming sub-tab interface.


7. Configure outbound routing

  1. Make your way to Connectivity > Outbound Routes > Add Outbound Route.

  2. Enter the route name, route CID and specify the Telnyx_IP trunk for this outbound route.

    Outbound Route configuration interface.

  3. Click Submit and Apply Config.


8. Configure inbound routing

  1. Make your way to Connectivity -> Inbound Routes -> Add Inbound Route.

  2. Enter the route name description, DID associated with this route and specify the extension that should be associated when calls are received to the DID.

  3. Click Submit and Apply Config.

Note: By default, when creating a SIP Connection in the Telnyx Mission Control Portal, the number formats for the ANI and DNIS will be set to E.164. This means Telnyx will send the dialled number in the SIP INVITE to your FreePBX system with 11 digits. As the DID number above is in 11 digit format, the call will be accepted and routed to the extension. However, you can control the number formats as you desire and can read more about it here.

That's it, you've now completed the configuration of FreePBX V13 IP Trunk and can now make and receive calls by using Telnyx as your SIP provider!


Additional Resources

Review our getting started with guide to make sure your Telnyx Mission Control Portal account is setup correctly!

Additionally, check out:


Did this answer your question?