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

Open SidemenuDocs
Close Sidemenu

Configuring Fusion PBX 4.4 Credentials Trunkconfiguring-fusion-pbx-4-4-credentials-trunk

How to configure a Fusion PBX Trunk

Intro To Fusion PBX 4.4intro-to-fusion-pbx-4-4

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

Fusion PBX 4.4 Credentials Prerequisitesfusion-pbx-4-4-credentials-prerequisites

  1. 1Download - There are currently 4 downloads available for unix based systems only. Download them hereTelnyx Developers.
  2. 2Install Fusion PBX - You can view the installation guide hereTelnyx Developers
  3. 3Dashboard Configuration - Your Telnyx Mission Control Portal

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

Fusion PBX 4.4 Setup Guidefusion-pbx-4-4-setup-guide

Operating System Setupoperating-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 Installationvirtual-box-machine-installation

Step 1: Download the Debian Network Installerstep-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 VMstep-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 systemstep-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 FusionPBXinstall-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 (Terminal)setup-commands--terminal-

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.


Call Configurationcall-configuration

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 Resources

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