How To Create Asterisk Server Dashboard In 10 Minutes

April 16th, 2017
Print Friendly, PDF & Email

Asterisk Dashboard

Updated for new FreePBX version

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

Asterisk PBX has been used by many businesses today and is an excellent choice for many types of businesses and needs. Asterisk is powered by some very rich features; you should pay more than 10K US dollars for other platforms and PBX systems. But one of the big problems in Asterisk platforms is that they are very complicated to work with and need the user to have in-depth knowledge about settings.

One of the essential capabilities in any telephone system is reporting and monitoring. You can find a simple report and dashboard bundled with some copies of Asterisk. For example, you can only have a few numbers of dashboards and reports in the Elastix, or some other ones in the Asterisk now, or FreePBX.
But all of them not gives you a comprehensive idea of what has happened actually in your company and never cover all calls.
For example, in FreePBX, you can use the report section for incoming and outgoing calls in a simple table as depicted below.

FreePBX Report

In this article, I want to show you how you can Create an Asterisk 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 in the PBXDom website.


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:
Download the Collector software by click on the Download button and go to the next step.

Create Asterisk Server Dashboard

Step 5:
Install collector software and copy your license key and 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.

Create Asterisk Server Dashboard

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

Create Asterisk Dashboard

Now you can click on the Next button.

Step 7:
Select Asterisk from the vendor list.

Asterisk Calls Dashboard

Select Asterisk from the model list and click on the next button.
Create Asterisk Server Dashboard

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

Create Asterisk Server Dashboard

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

Asterisk CDR Report

Step 10:
Enter your Asterisk 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 “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 Asterisk server accepting connection from the collector server.

Asterisk Reporting

For configuring your Asterisk server, connect to your Asterisk by putty or any SSH client.

Asterisk Monitoring

Enter your Asterisk server IP address and click on the Open button.
If it’s the first time you are trying to connect your Asterisk server from your machine, you see a warning message as illustrated below. You should click on Yes to continue.

Asterisk Dashboard Software

When connected enter your username and password for your Asterisk server.
Create Asterisk Server Dashboard

After connection to server edit /etc/asterisk/cdr_manager.conf with the following command:

vi /etc/asterisk/cdr_manager.conf

Create Asterisk Server Dashboard

And press Enter key.
In the editor, change enabled to “yes” in the general section.
Change from

Create Asterisk Server Dashboard


Create Asterisk Server Dashboard

To enable editing mode press, I key on your keyboard and to finish it, press ESC.
Create Asterisk Server Dashboard
For saving type: and “wq” and enter

edit /etc/asterisk/manager.conf And add a new line after admin section with the following command:

vi /etc/asterisk/manager.conf

Create Asterisk Server Dashboard

Move cursor to the end of file and write the following lines:

secret = pbxdom
read = all
write = all
eventfilter=!Event: RTCPSent
eventfilter=!Event: RTCPReceived
eventfilter=!Event: VarSet
eventfilter=!Event: Newexten

Create Asterisk Server Dashboard

For save type: and “wq” and enter

Create Asterisk Server Dashboard

Restart your Asterisk server by the following command:

Service asterisk restart

Create Asterisk Server Dashboard

After configuring your Asterisk server click on the next button on PBXDom wizard.

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

Create Asterisk Server Dashboard

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 by clicking the button below:

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

Create Asterisk Server Dashboard

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

Create Asterisk Server 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 60 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 reports, and chart section.
I hope this article helps you to find a very easy solution for making a Real-time dashboard for Asterisk-based systems.

Reza Mousavi
Print Friendly, PDF & Email

Share this article on social networks:

Related Posts

Guess less and know more

Try PBXDOM for 14 days free
no credit card required.

Try free for 14 days