How To Create FreePBX Dashboard In 10 Minutes

How create FreePBX Dashboard
Reza Mousavi
Reza Mousavi
6 min read

Updated for new FreePBX version

I wrote a new article for the FreePBX dashboard by a Linux agent, and you can check it out first.

FreePBX is a web-based open-source graphical user interface (GUI) that manages Asterisk, a voice-over IP and a telephony server.

FreePBX is licensed under the GNU General Public License version 3. It is a component of the FreePBX Distro, an independently maintained Linux system derived from the source code of the CentOS distribution, having Asterisk pre-installed. It is also included in various third-party distributions such as The FreePBX Distro and AsteriskNow.

For more info about FreePBX, visit

This article wants to show you how you can Create a FreePBX Server Dashboard in 10 Minutes. If you are here for the same reason, then follow along with my instructions step by step.

Step 1:
Signup in PBXDom from the following link:

Step 2:
When you confirm your account by the link sent to your email, you are redirected to the setup page on the PBXDom website. Before start set up the PBXDom collector software, I draw your attention to the following diagram. It shows the connection between your FreePBX and PBXDom.


Download the Collector software by click on the Download button and go to the next step.

FreePBX step 2

Step 3:
Before beginning, you will need:
1-Administrator access to the computer on which you will install.
2-Ability to configure the firewall to allow the collector to send data to PBXDom.
3-Know about your PBX available connectivity options and needed hardware.
4-Run setup.exe as Administrator by right-clicking on setup.exe and selecting the Run as Administrator.
5-Make sure nothing is blocking your access to the Internet.
6-If you’re behind the firewall, PBXDom collector software uses the following TCP/IP ports:
TCP: 80,443,13,37
UDP: 123
7-Make sure no Windows Policy/Antivirus is preventing the execution of the collector. You can exclude PBXDom collector’s executable files and the entire application directory.

Step 4:
After make sure about all the requirements, go to the next step.


Step 5:
Install collector software, copy your license key, paste it into your collector, and press the register button. After your collector registered successfully, press the start button on your collector.
Please watch the following video to know how to install the collector data.

Step 6:
In the next step, you will see the following window.


If you successfully registered your collector and started it, the PBX collector registration status changes from Not registered to Registered and collector connection status from Not connected to Connected like the following window after a few seconds.


Now you can click on the Next button.

Step 7:
Select Asterisk from the vendor list.


Select Asterisk from the model list and click on the Next button.


Step 8:
Click on LAN connection and click on the Next button.


Step 9:
Select only your time zone and leave other settings as set by default.


Step 10:
Enter your FreePBX server IP address in the Host field and leave other settings as set by default.

You have to enter your extensions and trunks here, if you did not enter them, the PBXDom can’t identify them correctly, and you can’t see anything on your dashboard. For finding your extensions and trunks list, you can use the GUI web console, or you can use the following command in your Asterisk server:

1-Login into your Asterisk server by SSH
2-Enter the following command:

asterisk -rx "sip show peers"

Finally, to send settings to your collector, click on the “send settings to the collector software button.”


After the settings are successfully sent to your collector, you should see the following message, and you can click on the Next button.


Step 11:
On Windows, you can find information about how to configure your FreePBX server accepting a connection from the collector server.


For configuring your FreePBX, open the FreePBX web console, and select “Asterisk Manager Users” from the “Settings” menu.

FreePBX AMI Users

Click on the “Add Manager” button.


Enter manager name, manager secret, and IP address of the computer the collector software installed on it.


1-“Manager name”: pbxdom
2-“Manager secret”: pbxdom
3-“Permit”: The IP address of the computer the collector software installed on it

And click on the “Submit” button to save data.

Select “Config Edit” from the Admin menu.


On the left panel, scroll down and find the “Asterisk System Configuration Files” folder and select it.


Click on the “Add New File” button and enter cdr_manager.conf as the filename, and click OK.


If it is created successfully, you should see the following window. (If you already have the cdr_manager.conf file, edit it)


Add the following value to the right-side panel as file content:

enabled = yes

And click on the “Save” button.


Finally, from the top menu, click on the “Apply Config” button.


Notice: In some cases, you should reboot or restart your FreePBX server to ensure your settings apply.

After configuring your FreePBX, click on the Next button on the PBXDom wizard.

Step 12
In the next window, you should wait till all the call data get loaded to your account.


Please don’t leave this page until you receive the OK status for all four rows below,
This should not take more than 10 minutes. If you don’t notice all the OK within this time, please review your settings.

Also, make some test calls with your PBX to include a few incoming, outgoing.

If the issue is still unresolved, please schedule a Free remote installation service from the support menu.

After a few minutes, you should receive 4 OK and windows change to the following message on your screen:


Congratulation, Please click on the Finish button to access your calls dashboard.


You can make as many as 50 dashboards as you want in the PBXDom. You can add up to 12 widgets in each dashboard from more than 70 available widgets.

Also, you can share a read-only dashboard all across your entire organization.

Finally, you can find a complete set of reports, charts in the reports and chart section.

I hope this article helps you find an easy solution for making a dashboard for FreePBX systems.