Installing The FreePBX Module On FreePBX 2.8 And Lower

NOTE: If you are using Elastix, please refer to the special support note on installing the FreePBX module on Elastix systems.

NOTE2: We can't guarantee that our module will work on very old versions of FreePBX.  While we have done our best to test this, your mileage may vary.  If it doesn't work, we recommend you upgrade FreePBX to at least version 2.9.

STEP ONE - You must make sure JSON is installed as part of your PHP installation.

Do this by opening an SSH session into the server and logging in as root.  Enter the following commands:

[root@demopbx ~]# yum install php-pecl-json

Setting up Install Process
Resolving Dependencies
--> Running transaction check
---> Package php-pecl-json.i386 0:1.2.1-4.el5 set to be updated
--> Finished Dependency Resolution

Dependencies Resolved

Package Arch Version Repository Size
php-pecl-json i386 1.2.1-4.el5 epel 15 k

Transaction Summary
Install 1 Package(s)
Upgrade 0 Package(s)

Total download size: 15 k
Is this ok [y/N]: y
Downloading Packages:
php-pecl-json-1.2.1-4.el5.i386.rpm | 15 kB 00:00
warning: rpmts_HdrFromFdno: Header V3 DSA signature: NOKEY, key ID 217521f6
epel/gpgkey | 1.7 kB 00:00
Importing GPG key 0x217521F6 "Fedora EPEL <>" from /etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL
Is this ok [y/N]: y
Running rpm_check_debug
Running Transaction Test
Finished Transaction Test
Transaction Test Succeeded
Running Transaction
Installing : php-pecl-json 1/1

php-pecl-json.i386 0:1.2.1-4.el5

[root@demopbx ~]# service httpd restart
Stopping httpd: [ OK ]
Starting httpd: [ OK ]


Go back to the FreePBX GUI --

Click on the 'Module Admin' link on the setup tab, then click on Upload module

Next, select the FreePBX module .tgz file that you downloaded from the website.  If you need to download again, click here:

SHA256 Checksum: bd8121c44774f9ca8e33aaf00496d172a280171494fc29437dee56b49406b09b

Next, click on the 'Manage Local Modules' link.


Scroll down to the Connectivity section of the page, click on the link then select 'Install'.  Scroll back to the top and hit PROCESS.


Hit the Confirm button and then Apply Configuration Changes.

You will now see the module underneath 'Connectivity Options' on the Left Navigation Bar:

Click on and you will see the module home page the menu on the far-right of the screen will look like this:

Click on 'Add Account' on the right side and PASTE your secret key from the website:


Once the key is added, it will securely communicate with the servers and pull all of your Trunk and DID information into FreePBX.

Make sure to follow the on-screen instructions, and then hit the SAVE button, followed by APPLY CONFIGURATION changes.

You should now see your trunks registered and outbound route properly configured in FreePBX!

To manage your DIDs and associated Inbound Routes, simply click on the Trunk underneath 'Trunks and Telephone Numbers' in the upper right corner of the module.  From there, you can set the inbound routes, save, apply and they will be pushed into the Inbound Routes section of FreePBX.  In addition, if you make any modifications within the Inbound Routes section of FreePBX, they will also sync back to the module.

If you have any questions on how to use the module, please open a Support Ticket for further assistance.


Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request


Powered by Zendesk