Open SidemenuDocs
Close Sidemenu

Bring Your Own Carrier: Telnyx & FreePBX bring-your-own-carrier--telnyx---freepbx-

The Telnyx network offers unparalleled security, reliability and call quality. That’s because we’re a true carrier. And, unlike many CPaaS providers, we don’t rely on middlemen to provide core communications functionality and routing.

We built our SIP services so that you can easily integrate Telnyx with any platform to get your business communications set up quickly. Whether you’re looking to integrate with hardware or cloud-based solutions, we empower you to make and receive calls globally with the network built for reliable, enterprise-grade voice services.

This guide shows you how to connect your Telnyx numbers to FreePBX. FreePBX is a web-based, open source GUI (graphical user interface) that controls Asterisk (PBX) open source communication servers. FreePBX can be customized to manage communications for any business, from home offices to global corporations and call centers. Configure this PBX for making and receiving calls over the internet through a next-generation carrier like Telnyx!

What you’ll need to get started with FreePBX:what-you-ll-need-to-get-started-with-freepbx-

  1. 1A Telnyx account - Sign up here with your email address, or register with your Google, Facebook or GitHub account - it only takes a few seconds.
  2. 2A download of FreePBX v14Telnyx Developers.

How it works


A Telnyx Elastic SIP Trunk is used to connect your IP-based communications infrastructure to the PSTN, so you can make and receive calls globally with our private IP network. We handle all the complexity in routing calls and delivering crystal clear conversations. To connect your Telnyx numbers to your FreePBX platform we need to establish a SIP interface which is completed in these steps:

  1. 1Set up your Telnyx SIP Trunk Connection.
  2. 2Authenticate your SIP Trunk with FreePBX.
  3. 3Configure your FreePBX profile for Inbound and Outbound calling.

Getting Started with Your Telnyx Mission Control Portal

There are four steps needed to set up your Telnyx Mission Control PortalTelnyx Developers account so that it’s ready to be configured to your PBX phone system, softphone client or softswitch of your choice.

Level 1 Verification:

To complete the below steps, you'll need to be Level 1 verified. Most users will already be Level 1 verified following email confirmation on signup. To check, visit the ‘My Account’ section of your portal account, and navigate to ‘Verifications’. More information on account verification can be found hereTelnyx Developers.

Connection Setup

Next, you need to set up a connection to authenticate your client (FreePBX) with our sip proxy (sip.telnyx.comTelnyx Developers).

These steps will walk through the setup of a credentials based connection. For information on IP and FQDN, check out the instructions hereTelnyx Developers.

  1. 1Go to ‘Connections’ from the side navigation.
  2. 2Click the "+ Add Connection" button near the top right corner of the page.
  3. 3Enter the name you wish to have for your connection.
  4. 4Select "Credentials" as the "Connection Type". Click hereTelnyx Developers for IP or FQDN setup.
  5. 5A username and password will automatically be generated but you change the credentials by clicking the "edit" button to the left. Please make sure you use strong credentials.
  6. 6Click "Set Credentials".
  7. 7Click "Done"

Note: Once your credential-based Connection is created, you can display the username and password by clicking the eye icon under the "Auth Detail" column.


A DID is required in order to receive inbound calls to your client. After you purchase a DID on your account, you'll have to assign the connection you wish to receive inbound calls to. Information on assigning DIDs to a connection and DID features can be found hereTelnyx Developers. More details on our number search feature can be found hereTelnyx Developers.

Outbound Profile

An outbound profile is required in order to make outbound calls. More information on creating an outbound profile and its features are explained hereTelnyx Developers.

Need additional support to get started?

Check out our support guideTelnyx Developers. Supplementary information for configuring your client, such as the signaling and media IP’s to our SIP proxy can be found at sip.telnyx.comTelnyx Developers.

Setup FreePBX for Your Telnyx Connectionsetup-freepbx-for-your-telnyx-connection

Your Mission Control Portal is now setup. You’re ready to configure your Telnyx trunk within your FreePBX V14 system.

FreePBX Installation

Installing FreePBX is fairly straightforward. You’ll just need internet access, and a username and password for your FreePBX account. We’ll point out the important steps to perform a full install using Asterisk 13.

  1. 1When you load the ISO onto your server or virtual machine, the first screen will ask you to select your installation type.


  1. 2Select your preferred video method for the installation. The installer will start once you finish this step.


  1. 3Once the installer starts, click on the root password box to set your root password. Type in your root password and confirm it. A root password is required to complete the installation.


  1. 4The FreePBX installation will start. Installation can take 15 minutes or more to complete, depending on your internet speed.
  2. 5Once the installation is complete, click on “reboot”.
  3. 6After the system reboot finishes, you’ll be presented with a Linux command prompt login. Use the username “root” (without quotes) and the root password you set earlier to login.


  1. 7After you log in, the IP address of your PBX will be displayed under “IP addresses” in the table. Write this IP address down or remember it. You need it for the next step.
  2. 8Open your web browser and enter the IP address into the URL bar. The first time you do this, you'll be asked to create an admin username, admin password and enter an administrator email address. This username and password will be used to access the FreePBX configuration screen.


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

Basic FreePBX Configuration

After you complete your FreePBX installation, you’ll need to do a few things to complete your basic FreePBX setup. All of these steps are accessed by clicking the “FreePBX Administration” option from the base dashboard, and logging in with the administrator username and password you created. Navigate the interface using the tabs at the top of the screen.


  1. 1The first time you login, you’ll be guided through a series of steps to activate your FreePBX, including selecting your default language and timezone, and selecting options for your firewall. You’ll return to the dashboard when you’re finished.

Now you must confirm your network settings and configure your SIP trunks and extensions.

  1. 2Click the “Settings” tab, then click “Asterisk SIP Settings”.


  1. 3Navigate to the “General SIP Settings” tab, and ensure the external and local network addresses are populated. You may need to click “Detect Network Settings” to get the addresses to populate.
  2. 4Click “Submit”. Then click “Apply Config”.

Extensions Configuration

  1. 1Click on the “Applications” tab.
  2. 2Click “Extensions”, then click “Add Extension.”
  3. 3Click “Add new Chan SIP Extension” to open the SIP extension configuration screen.
  4. 4Enter the number you purchased in the Telnyx Mission Control Portal in the Outbound CID field.


You may see a warning that says, “This device uses CHAN_SIP technology listening on Port 5160 (UDP - this is a NON STANDARD port)”. This is normal.

  1. 5You can add an extension password in the “Secret” field. Occasionally, the “Secret” field is located under the “Other” tab.
  2. 6Click “Submit”, and then click “Apply Config”.

SIP Trunks Configuration

  1. 1Click the “Connectivity” tab.
  2. 2Click “Trunks”, then click “Add Trunk”.
  3. 3Click “Add New Chan SIP Trunk”. This will take you to the “General” tab of the trunk configuration screen.


  1. 4Enter a trunk name.
  2. 5Enter the outbound CID you added in the extension configuration for the “Outbound CallerID”, and the maximum channels you'd like for this trunk.
  3. 6Click the “Dialed Number Manipulation Rules” tab.
  4. 7Depending on your use case, we've provided a simple dial pattern US numbers below.

For US numbers, use these simple dial patterns:

  • prepend: 1; match pattern: NXXNXXXXXX
  • prepend: blank; match pattern: 1NXXNXXXXXX

Use these dialing patterns for international numbers:

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

The configuration should look like this:


  1. 8Click on the “SIP Settings” tab.
  2. 9Click on the “Outgoing” tab. Copy and paste these settings into the “PEER Details” box:
  • type=friend
  • qualify=yes
  • insecure=port,invite
  • disallow=all
  • allow=ulaw


  1. 10Click on the “Incoming” tab. Copy and paste these settings into the “USER Details” box:
  • type=friend
  • insecure=port,invite
  • dtmfmode=rfc2833
  • disallow=all
  • allow=ulaw


Outbound Routes

  1. 1Click the “Connectivity” tab.
  2. 2Click “Outbound Routes”, then click “Add Outbound Route”.
  3. 3Enter the route name and route CID (the same number you purchased in the Telnyx Mission Control Portal).
  4. 4Specify the Telnyx_IP trunk in the “Trunk Sequence for Matched Routes”.
  5. 5Click “Submit”, then click “Apply Config”.


Inbound Routes

  1. 1Click the “Connectivity” tab.
  2. 2Click “Inbound Routes”, then click “Add Inbound Route”.
  3. 3Enter the route name and DID associated with this route.
  4. 4Specify the extension that should be associated when calls are received to the DID.
  5. 5Click “Submit”, then click “Apply Config”.

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

A little disclaimer: This guide has been developed by our product team to help you get started on the Telnyx platform. It isn’t necessarily supported or verified by the other platform and may vary based on platform version but we are confident in its accuracy.

Support and Additional Resources:

  • Review our getting started guideTelnyx Developers to make sure your Telnyx Mission Control Portal account is set up correctly!
  • Check out FreePBX's help sectionTelnyx Developers for extra support!
  • Looking for additional help? Click the Live Chat icon at your lower right-hand corner and start a chat.

Was this page helpful?