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 a Credentials 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.

Instructions on Configuring a FreePBX V13 Credentials Trunk


FreePBX V13 is available to download from here.


You can view the installation guide here.

Video Walkthrough

Coming soon! This walkthrough will demonstrate setting up a credentials based connection with FreePBX. We'll also show you how to assign this connection to a newly purchased DID which will allow you to receive inbound calls. Then we'll walk you through how to assign the connection to an outbound profile such that you can make outbound calls!


For step by step instructions on each of the requirements on the Telnyx Mission Control Portal, please follow this guide.

Once you've configured your Telnyx account, you can now proceed to setup FreePBX V13 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.

1. Confirm your appropriate network settings.

2. Confirm your root password.

3. Wait for all the necessary packages to be installed.

4. More modules will be updated after successful internet tests.

5. Enter root and the password you created from step 2.

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

Basic Settings Configuration

1. You'll be brought to the initial setup and must enter in the username, password and admin email address in order to create your account.

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

3. Follow the process to activate your FreePBX V13.

4. Select your default locales.

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

Eventually, you'll be back at the dashboard and now see more details.

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

Video Walkthrough

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

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

Click Submit and then Apply Config.


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.

If you do not set an Outbound CID for your Extension, you must enable this on your trunk.

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

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.


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

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

Note: Enter a Trunk name, your Outbound CID and the maximum channels you'd like for this trunk. 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.

Proceed to the Dialed Number Manipulation Rules tab.

Depending on your use case, we've provided a simple dial pattern US numbers below.

For US numbers:

  • prepend:1; match pattern: NXXNXXXXXX

  • prepend: blank; match pattern: 1NXXNXXXXXX


  • prepend: Country Dialing prefix; match pattern: NXXNXXXXXX

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

Proceed to the SIP Settings tab. In the sub tabs outgoing and incoming, you'll want to include the following below settings:

Outgoing SIP Settings for the trunk:

  • username=your_sip_connection_credentials_based_telnyx_username

  • secret=your_sip_connection_credentials_based_telnyx_password

  • type=friend

  • qualify=yes

  • insecure=port,invite



  • disallow=all

  • allow=ulaw&alaw

Inbound SIP Settings for the trunk:

  • username=your_sip_connection_credentials_based_telnyx_username

  • secret=your_sip_connection_credentials_based_telnyx_password



  • type=friend

  • insecure=port,invite

  • qualify=yes

  • disallow=all

  • allow=ulaw&alaw

  • dtmfmode=rfc2833

Register String:


Outbound Routes

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

Enter the route name, route CID and specify the Telnyx_Cred trunk for this outbound route. Click Submit and Apply Config.

Inbound Routes

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

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.

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 Credential 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!

Check out FreePBX's help section for community or paid support.

Can't find what you're looking for?

Our knowledge base is currently undergoing a makeover which will include more up to date videos to match our ever growing platform!

Can't find what you're looking for? Click the chat bubble at your lower right hand corner and start a chat!

Did this answer your question?