Guide to setting up the FreeSWITCH-based multi-tenant PBX, FusionPBX

FusionPBX is a FreeSWITCH-based multi-tenant PBX that provides a robust set of features for business phone systems.

Using SignalWire services with FusionPBX allows you to leverage our high call quality and low rates.

The following are assumed for this tutorial:

  1. You already have a SignalWire Space set up
  2. You have purchased a US/Canadian DID
  3. You have created a SIP endpoint
  4. You have set the number purchased above to point to this SIP endpoint for handling voice calls, and for it’s CallerID. Take note of the username and password you enter.

If you need help with any of the above, you can find a basic guide here and our SIP guide here.

FusionPBX GUI setup

From your FusionPBX installation's web GUI go to Accounts > Gateways. This is where you will use the credentials you previously created.

Next, click the ADD button at the top left.

Enter the following information in the Gateway form:

  • Gateway: This is a label. In this example we will define this as signalwire
  • Username: Your username as created in the SIP endpoint on SignalWire
  • Password: The password you set above
  • Proxy: YOURSPACE-SIPDOMAIN.sip.signalwire.com (Replace with your proxy address)
  • Register: True

*Note: The Proxy address can be found in the SignalWire dashboard by going to SIP > SIP Settings tab as shown below.

Click the Advanced button to expand additional settings

  • Register Transport: TLS (This can also be TCP but is better to be secure with TLS)
  • Ping: 90
  • Profile: internal
  • Enabled: True Click save at the top right corner.

Your form should look similar to the following.

*Note: In order to use TLS on your FusionPBX installation, SSL certificates like Let's Encrypt need to be configured. How to do this can be found in the FusionPBX member documentation

You should now have a gateway registered(REGED) as shown in the image below.

*Note: You may have to click Start to initiate registration.

Making outbound calls over SignalWire

After the gateway is configured in your FusionPBX installation and registered we can now configure an outbound route.

Go to Dialplan > Outbound Routes and click the ADD button at the top right.

Fill in the form with a few simple settings:

  • Gateway: Select signalwire from the drop down list
  • Dialplan Expression: Choose North America (This can be typed in manually or you can pick other areas also)

Check your form is similar to the following, and click Save.

Setting up an extension to receive a call over SignalWire

Go to Accounts > Extensions. Here you can create an extension. This is needed to point your registered peer to so you can receive calls.

Create an extension by clicking the Add button at the top right. In this example we will create extension 900 and click Save at the top right.


Go to Dialplan > Destinations from your FusionPBX installation. We will now create an inbound route to connect the SignalWire peer and the extension you just created.

Create a destination by clicking the +ADD button at the top right.

Fill in the form with the necessary information

  • Destination: Your SignalWire phone number, without the +1 (eg. 5556677888)
  • Caller ID Name: This is optional (also see the documentation for Caller ID settings on SignalWire)
  • Caller ID Number: This is optional
  • Actions: 900 (This is where the call will go to). The actions can be an extension, IVR, Time condition, etc.

Click the Save button at the top right, after checking your form looks similar to the following.

Setting up the "SIP to user" FusionPBX feature

This is a very important step. This must be set in order to receive calls to your FusionPBX installation.

In the menu, look for Advanced > Default Settings and click the Add button on the top right.

In the form, enter the following information:

  • Category: dialplan
  • Subcategory: destination
  • Type: text
  • Value: ${sip_to_user}
  • Enabled: True
  • Description: optional

Check the form looks similar to the following, then click Save. After saving, click the top right Reload button.

This should give you a base FusionPBX setup that can make and receive calls using SignalWire. Let us know what cool things you build with it.