This is the current API V1 documentation. Explore our API V2 if you’d like to test new features.

Open SidemenuDocs
Close Sidemenu

How to configure a Fusion PBX 4.4 Credentials Trunkhow-to-configure-a-fusion-pbx-4-4-credentials-trunk

How to configure a Fusion PBX Trunk


FusionPBXTelnyx Developers can be used as a highly available single or domain based multi-tenant PBX, carrier grade switch, call center server, fax server, voip server, voicemail server, conference server, voice application server, appliance framework and more. FreeSWITCH™ is a highly scalable, multi-threaded, multi-platform communication platform. This article guides you on how to configure this PBX for making and receiving calls over the internet through a next generation carrier like Telnyx!

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 outbound calls. This provides you with the username and password you will use to register FusionPBX with Telnyx.



There are currently 4 downloads available for unix based systems only. Download them hereTelnyx Developers.


You can view the installation guide hereTelnyx Developers.

Video Walkthrough

Coming soon! This walkthrough will demonstrate setting up a credential based connection with FusionPBX. 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!

Configuring Your Telnyx Mission Control Portalconfiguring-your-telnyx-mission-control-portal

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 Fusion PBX following the guide below.

Fusion PBX Setup Guidefusion-pbx-setup-guide

Operating System Setup

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

We recommend using Debian as the operating system version that should be running FusionPBX. The current Debian version that we tested FusionPBX on was Debian-9.9.

There are many applications that can be used to set up a Debian Operating System on your computer. In this article we use a program called VirtualBOX VM to set up a Debian Virtual Machine. Follow these steps to install the Virtual Machine on your computer. If you don't want to use a Virtual Machine you can skip these steps and go straight installation of the FusionPBX.

Virtual Box Machine Installation

Step 1: Download the Debian Network Installer

Go to the debian websiteTelnyx Developers and download the network installer disk image.

Step 2: Create a New VirtualBox VM
  1. 1Name and OS Type
    1. 1Click on the New icon in the VirtualBox menu bar.
    2. 2This will start the New Virtual Machine Wizard. The first screen is just a welcome screen so click Continue to proceed.
    3. 3Name field: enter any name you choose.
    4. 4Operating System field: enter “Linux”.
    5. 5Version field: enter “Debian (64 bit)”
    6. 6Click Continue


  1. 2MemoryUse the default setting for the amount of base memory.


  1. 3Virtual Hard Disk We will create a new virtual hard disk to use as our VM file system.
    1. 1Use the default setting on this screen.
    2. 2In the next screen, select the format for the virtual hard disk.
    3. 3Use the default settings, the native VirtualBox Disk Image (VDI) format.
    4. 4Then, click Continue.


  1. 5Move to the next screen where we need to choose between a Dynamically Allocated or a Fixed size virtual disk file.
  2. 6We should choose “dynamically allocated”, which is the default.


  1. 7Again, we just use the defaults, when choosing the location and maximum size of the VM disk image file on your host computer’s file system.


  1. 8Then you click create to proceed. You will then see this screen.


Step 3: Insert the Debian install file into the VM storage system

Go into the settings on the debian VM and you will see an option for storage. Click on this and select the Debian file you downloaded earlier as the Controller: IDE. Like pictured below.


Now you can see that the network install ISO image is configured for the Debian VM. We should be able to start it now and it will boot from the image and the software on the disk image will start the Debian Linux installation process in the virtual machine.

Once you have that completed you can go to the Virtual Box home page and select power on for your Debian Virtual Machine. Once you have done that you will go through the configuration of your virtual machine like languages etc. After that you should be good to go to install your FusionPBX.

Install FusionPBX

FusionPBX can be installed on several different operating systems however we recommend using Debian. If you are installing Debian from scratch it will have prompted you during the installation phase to have created a root password. This will be the password you will enter when you run the command "su root" in the terminal.

Visit this website where FusionPBX recommends that you follow the install scriptTelnyx Developers as it is much simpler and faster than previous ways.

FusionPBX also have a youtube video demonstrationTelnyx Developers available to walk you through the process.

Setup Commands

Run the following commands as root. The script installs FusionPBX, FreeSWITCH release package and its dependencies, iptables, Fail2ban, NGINX, PHP-FPM and PostgreSQL.

  1. 1These are the commands that you will enter into the terminal.
  • Upgrade the packages
apt-get update && apt-get upgrade -y
  • Install packages
apt-get install -y git lsb-release
  • Get the install script
cd /usr/src && git clone
  • Change the working directory
cd /usr/src/

At the end of the install script you will be instructed to go to the IP address of the server in your web browser to finish the install in the FusionPBX GUI.


Once you have opened a browser with the URL the terminal gave you, you should see a GUI where you will go on to configure FusionPBX.

  1. 2Choose your language and click next


  1. 3Your event socket settings will be automatically detected so you can click next again.


  1. 4Here you will need to enter a username and password as your login credentials for FusionPBX.


  1. 5Any writing in bold indicates that you must fill it in. At this point you will need to go back to the terminal and grab the details you would have seen, just above the server IP, that relate to the database username and password. Click next.


  1. 6You'll be brought back to the login page where you will sign in with the username and password from the screenshot number 4.



Once you have the installation of your FusionPBX set up, It is now time to configure your PBX so that you can make and receive calls through Telnyx!

  1. 1Go to the Advanced header and to Upgrade in the drop down list. Make sure to tick App Defaults and press the execute button on the bottom right


  1. 2Go to the Accounts header and select Gateway.
    • Gateway = Telnyx
    • Username = The username from your Telnyx credentials based connection.
    • Password = The password from your Telnyx credentials based connection.
    • From User = The username from your Telnyx credentials based connection.
    • From Domain =
    • Proxy =


  1. 3At this point you can click save. The next screenshot will show you that your Fusion-PBX server has registered with our domain.


  1. 4Go to the Accounts header and select Extensions. You will need to click the Add button to add your extensions in, I have added two extensions below.


  1. 5Click into the extension you just created and change the password that was given if you want. This is an example config of an extension, account code will be your servers IP and automatically filled. Click Save.


  1. 6Go to the Dialplan header and select Destinations. Click the Add button to add your destinations.


  1. 7You'll want to add in a number that you purchased on your Portal account to Destination - Make sure to add a +1 in front of the number. Then for Actions, select an extension you created from the drop-down list. Click save.


  1. 8Go to the Dialplan header and select Inbound routes. Your inbound routes should be added automatically that relate to your destinations you created.


  1. 9When you click on any of the numbers you created as inbound routes you will see a dialplan like the picture below. You will need to make sure that your number format is set to E164 on your connection you created in your Mission Control Portal.


  1. 10Go to the Dialplan header and select Outbound routes. Click the Add button to create your different outbound routes.


  1. 11Outbound Routes
  • Gateway = Telnyx from drop down list
  • Dialplan Expression = North America from drop down list but you can choose other types also.
  • Click Save.


  1. 12Registrations
  • Go to the Status header and select Registrations. At this point you will need to register the extensions you created with whatever device you choose.
  • In my case I used Zoiper and Xlite softphone to register both my extensions. All your registered devices will show up on the registration’s page below.
  • Both extensions are registered with the servers IP address so they can now make and receive calls internally via calling 1000 or 1001. Your inbound and outbound routes are set and you will be able to make and receive calls externally also.


That's it, you've now completed the configuration of FusionPBX and can now make and receive calls by using Telnyx as the SIP provider.

Additional Resourcesadditional-resources

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

Check out FusionPBX's help sectionTelnyx Developers for extra support!

Can't find what you're looking for?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 Live Chat icon at your lower right hand corner and start a chat!