This is the API V2 documentation. To switch out of beta revert back to our API V1.

Open SidemenuDocs
Close Sidemenu

How to configure a FreePBX Version 14 Credentials Trunkhow-to-configure-a-freepbx-version-14-credentials-trunk

Introduction to FreePBX v14

FreePBXTelnyx Developers 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 connectionPORTAL on your Telnyx Mission Control Portal account, assigned this connection to a DID and outbound profile in order to make and receive calls.

FreePBX v14 Prerequisitesfreepbx-v14-prerequisites

  1. 1Download - FreePBX v14 is available to download from hereTelnyx Developers.
  2. 2Installation - You can view the installation guide hereTelnyx Developers.
  3. 3Configure Your Telnyx Mission Control Portal

Once you've configured your Telnyx account, you can now proceed to setup FreePBX V14 following the guide below.

FreePBX Version 14 Setup Guidefreepbx-version-14-setup-guide

You are now all set on the Mission Control Portal side and are ready to configure your Telnyx trunk within your FreePBX V14 system.

Install FreePBX v.14install-freepbx-v-14

  1. 1Once 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. 2You'll be prompted for your preferred video method you want to install.


  1. 3The installer will now start.


  1. 4The installer will start but you will see it shows the root password is not set. You will need to click on the root password box to set your root password. The installation process can not complete until this is done.


  1. 5Type in your root password and confirm it a second time and click on the Done option in the top left screen.


  1. 6At this time the FreePBX package itself can take 15 or more minutes to install and does requires access to the internet so depending on your internet speeds it can take awhile to install so be patient.


  1. 7Once the install has 100% completed it will give you a reboot option as shown below. Click on reboot your your system is now installed.


  1. 8Once the process is complete, you'll reach the Linux console/command prompt login. You can log in here using the username "root" without quotes, and the Root password you selected earlier.


  1. 9After you log in, you should see the IP address of your PBX as shown below. Take note of this IP address as you will need it in the next step.


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


  1. 11The main FreePBX screen will offer you four options:
  • 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.


Basic Settings Configurationbasic-settings-configuration

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


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


  1. 3Follow the process to activate your FreePBX V14.


  1. 4Select your default locales.


  1. 5You'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.


  1. 6At this point you can now work on confirming network settings and configuring your SIP trunks and extensions. 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.



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

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

  2. 2Click Submit and then Apply Config.


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


  1. 1Make your way to Connectivity -> Trunks -> Add Trunk -> Add New Chan SIP Trunk. You'll now be located in the General tab.
  2. 2Enter a Trunk name, your Outbound CID and the maximum channels you'd like for this trunk.
  3. 3Specify an admin email and configure your mail server configuration by specifying a mail provider.


  1. 4Proceed to the Dialed Number Manipulation Rules tab.
  2. 5Depending 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
  1. 6Proceed 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:outgoing-sip-settings-for-the-trunk-


  • type=friend
  • qualify=yes
  • insecure=port,invite
  • disallow=all
  • allow=ulaw

Inbound SIP Settings for the trunk:inbound-sip-settings-for-the-trunk-


  • type=friend
  • insecure=port,invite
  • dtmfmode=rfc2833
  • disallow=all
  • allow=ulaw

Outbound Routesoutbound-routes

  1. 1Make your way to Connectivity -> Outbound Routes -> Add Outbound Route.
  2. 2Enter the route name, route CID and specify the Telnyx_IP trunk for this outbound route. Click Submit and Apply Config.


Inbound Routesinbound-routes

  1. 1Make your way to Connectivity -> Inbound Routes -> Add Inbound Route.
  2. 2Enter 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. 3Click Submit and 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!

Additional Resources

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

Checkout FreePBX's help sectionTelnyx Developers for extra support.

Can't find what you're looking for? Click the Live Chat icon at your lower right hand corner and start a chat.

Was this page helpful?was-this-page-helpful