A group of the most popular frequently asked questions related to XonTel technology

IP Phones XonTel series FAQ

VPN configurations can be setup using the following files:

  • Access to the phone by the default username and password
  • Go to account tab – then advanced then Dial Plan
  • The default dial plan is {[x*]+} if your extensions for example start with 1xx and you need dial 101 without # so you can change the dial plan to be like {1xx|[x*]+} so any dial number start with 1 and 3 digits will path as speed dial.
  • If we want to active BLF to extensions please , access to the phone
  • Go to function key
  • Memory key , then you can program first button to be BLF like below image

You can assign general ring tone to all lines and also you can assign per line you can find it account / advanced /

The reason that the phone has codes may make some conflicts with the PBX codes so it’s important to disable it from the phone from account / advanced / Enable Call Features make it NO.

Xontel Phone series has key lock option with password you can find this option at setting / features / Phone Lock.

Because all phones sync from NTP server and incase no internet so no sync

To solve this issue please follow setting / date & time / and change NTP server to your IPPBX IP , in this case the phone will sync from the PBX


The default IP address of XonTel IP PBX is

The default user name and password of XonTel IP PBX are:

User name: admin

Password: xontel

The login information of XonTel IP PBX User Web Interface is as below:

IP address: same as XonTel IP PBX server

User name: Extension number (e.g. 501)

Password: voicemail access PIN # of this extension (e.g. 501)

Note: the User is able to log in the User Web Interface only if the “User Web Interface” function is enabled by the admin in the Extension editing page.

Retry after refreshing the IE web page; if the problem has not been solved, please delete the cookie and cache of the browser.

The way to delete the cookie and cache of the browser (take IE browser as an example):

On the IE menu bar, select “Tools” –>”Internet options”, and select “general” on the pop-up window. Then Click the “delete” button of “Browsing history”.

On the Menu bar of XonTel IP PBX, click “PBX”->”Basic Settings”->”General Preferences”. In the “Extension Preferences” section, you can define the User Extensions range as you like.

Step 1: select the FXS extension to be changed and click “Delete”.

Step 2: click “Edit”, and change the Extension number in the General section on the “Edit Extension” page.

The number of FXS extensions (analog extensions) is determined by the number of S2 modules (one S2 module contains two FXS ports, i.e. 2 FXS extensions) and SO modules (one SO module contains one FXS port, i.e. 1 FXS extension) installed in XonTel IP PBX. So if you need to add FXS extensions, please make sure that there are empty module slots for S2 or SO module first.

Step 1: power off or unplug XonTel IP PBX.

Step 2: unscrew XonTel IP PBX, and open the upper case.

Step 3: insert the S2 or SO module into the corresponding slot and place back the upper case and tighten the 4 screws. Then power on XonTel IP PBX and new FXS extensions will be added successfully after rebooting.

XonTel IP PBX have done successful compatibility testing with the mainstream IP phone brands, such as Xontel , GULFSIP , Yealink, Grandstream, Cisco, Polycom, snom, Panasonic, Digium, Aastra, etc.

Please check if the value of IP phone UDP port is the same as that of XonTel IP PBX server (which could be checked by selecting “PBX”->”Advanced Settings”->”SIP Settings”). Please note that the default UDP port of XonTel IP PBX is 5060.

Step 1: map the corresponding communication port of XonTel IP PBX on the router. The default value of communication port is as below:

UDP: 5060

UDP: 10000-12000

Step 2: on the “SIP Settings” page, enable “NAT” mode, and enter public IP address of the router in the blank of “External IP Address”.

Step 3: add a VoIP extension on XonTel IP PBX and enable “NAT” and “Register Remotely” on the “FXS/VoIP Extensions” page.

Step 4: in the external network, the IP phone could register to XonTel IP PBX server with the extension number set up on step 3.

For detailed configuration instructions, please refer to

http://www.yeastar.com/download/Register-To-XonTel IP PBX-Remotely.pdf

Mobility Extension is a mobile number that enjoys all the authority of internal extensions, like direct calling other extensions, calling through trunks and voicemail checking when the number calls into XonTel IP PBX.

How to configure Mobility Extension?

Step 1: click “PBX”->”FXS/VoIP Extensions”. Then select the extension to be configured with Mobility Extension and click “Edit”.

Step 2: in the “Other Settings” tab, enable Mobility Extension and enter the corresponding cell phone number. Then the configuration of Mobility Extension is completed.

For example: if the cell phone number entered is 15960111111, then when the user calls in XonTel IP PBX with this number, he will hear the ringback tone first, and then the dialing tone after getting through. At that time, the cell phone can operate all the functions of Mobility Extension.

Note: Because XonTel IP PBX recognizes the caller as Mobility Extension via the match of “Caller ID”, please note the following two points if you would like to use this function.

  1. The trunk should be able to show Caller ID.

  2. If Call back function is enabled, the Mobility Extension function will be invalid automatically.

The number of Analog trunks (i.e. FXO ports) is determined by the number of O2 modules (one O2 module contains two FXO ports, i.e. 2 analog trunks) and SO modules (one SO module contains one FXO port, i.e. 1 analog trunk) installed in XonTel IP PBX. So if you need to add analog trunks, please make sure that there are emtpy module slots for O2 or SO module first.

The steps to add analog trunks are as below:

Step 1: power off or unplug XonTel IP PBX.

Step 2: unscrew XonTel IP PBX, and open the upper case.

Step 3: insert the O2 or SO module into the corresponding slot and place back the upper case and tighten the 4 screws. Then power on XonTel IP PBX and new analog trunks will be added successfully after rebooting.

In the configuration page of “VoIP Trunk”, click “Add VoIP Trunk”, and enter the following information in the popup window. (Take the IMS trunk provided by your ITSP as an example.)

Provider Name: your ITSP

Hostname/IP: the IP address provided by ITSP for registration (e.g.

Port: 5060

Domain: the domain provided by ITSP (e.g.sip.xyz.com)

User Name: the user name provided by ITSP

(e.g. [email protected])

Password: the password provided by ITSP

From User: +9733992111

Maximum Channels: the number of the channels of each line you applied for (e.g.2)

Caller ID: +9733992111

To solve this problem, please select “PBX””Advanced Settings””SIP Settings””Advanced Settings”, uncheck “Quality”, and then have a test. If the problem still exists, please check the firewall settings. If the firewall has been enabled, please add a rule in “Common Rules” to enable the pass of the UDP port: 5060 and UDP port: 10000-12000 for the registration IP address provided by the VoIP provider.

Every BRI module purchased will be supplied with a RJ45-RJ11 cable. (The RJ45 connector is to connect the port offered by BRI provider while the RJ11 part is for the BRI port of XonTel IP PBX. See Figure 4-1.)

Step 1: connect BRI trunk as the above instructions and log in the web interface (“Status” ->”Trunk Status”) to check if the connection is successful. If the connection is successful, then the status will show “OK”. If not, please select the right type of signaling that the service provider requires in the “Edit BRI trunk” page.

Note: the change of settings takes effect only after rebooting.

Step 2: configure inbound routes. One BRI trunk has two channels, i.e. two numbers. So if different destinations for them are preferred, two inbound routes should be defined for this BRI trunk and its two channels can be distinguished by DID numbers, that is, the two numbers of this trunk.

For example: The two numbers of the BRI trunk are 686867 and 686868. Then you can define two inbound routes (see Figure 4-2) to distinguish them.

After the configuration, the incoming calls from BriTrunk9 would reach XonTel IP PBX via two routes: BRIin1 (call the number 686867) or BRIin2 (call the number 686868).

Outbound routes are used to determine the authority or dial pattern for the extensions to make outbound calls to cell phones and landline phones, or make domestic long-distance calls and IDD calls.

Step 1: check if the selected trunks can be used in the “Trunk Status” page.

Step 2: select “PBX”->”Outbound Routes” and click “Add Outbound Route”.

For example, if the user would like to allow extensions 500-507 to make any outbound calls (i.e. any number starts with digit 0-9) via “PSTN4” trunk, please see Figure 5-1 for the detailed configuration. For more instructions, please refer to XonTel IP PBX User Manual.

Inbound Routes are used to determine the destinations of incoming calls of different time (i.e. office hour, non-office hour, and holiday). The steps of configuration are as below:

Step 1: click “PBX”->”Inbound Routes” and “Add Inbound Route”.

Step 2: in the “Add Inbound Route” page, select the trunks that you prefer for this route and then select different destinations for incoming calls of different time (see Figure 5-2). For more instructions, please refer to XonTel IP PBX User Manual.

a. If the problem just happens to one specific extension, please check if this extension has been selected in the outbound route.

b. If the problem happens to all extensions, i.e. all extension cannot make outbound calls, please follow the below steps.

Step 1: please make sure that the connection of XonTel IP PBX and the telecom lines is ok, and check if the lines are available (log in XonTel IP PBX Web Configuration Panel and select “Status”->”Trunk status”).

Step 2: if the trunk is available to use, please check the configuration of outbound routes (click “PBX”->”Outbound Routes”).

1) Check if the configuration of “Dial Pattern” is correct.

2) Check if the expected trunk has been selected.

That’s because the extension has new voicemails.

Please dial the feature code “*2” to check the new voicemails.

After all the voicemails have been checked, the “toot toot” sound would disappear.

The problem might result from one of the following configurations:

The extension has set up “Always transfer to voicemail”. The user can log in “User Web Interface” and uncheck the “Always transfer to voicemail” option.

The extension or the phone has enabled “DND” function.

1) If it is the extension that has enabled “DND”, then it can be canceled by entering the feature code (the default value is” *075”) on the phone. Also the user could log in “User Web Interface”, select “Settings” and uncheck the DND option.

2) If it is the phone that has enabled “DND” function, and you can see the “DND” on the phone screen, please cancel the “DND” function according to User Manual of the phone.

It’s because that the callee replaces its caller ID with English letters. When the “RD” button is pressed to call back, the phone will call the callee’s “Caller ID” directly. But XonTel IP PBX system recognizes the callee only by “Extension number” rather than “Caller ID”. So the phone screen would displays “unfound”.

Solution: Make the callee’s “Caller ID” equal to “Extension Number”.

It is because that the system has enabled “Business Hours” and the destination of “Non-office hour” has been configured to “End calls” in the inbound routes. Please follow the steps to change the settings:

Step 1: figure out which is the trunk that has the problem and check all the inbound routes that use this trunk.

Step 2: solve the problem by changing the destination of “Non-office hours” in the “Edit Inbound route” page.

It’s because that XonTel IP PBX has mapped the port to WAN without configuring firewall settings (i.e. no definition of corresponding common rules) and has been attacked. Please configure the firewall settings according to XonTel IP PBX User Manual.

It might result from:

  1. The trunk doesn’t have Caller ID service.

In order to confirm it, please connect the PSTN line directly to the analog phone and call it via cell phone to check if there is Call ID on the phone. If there is no Caller ID, please contact the service provider.

  1. Wrong settings of “Caller ID Start” and “Caller ID Signaling”.

In this case, please change their settings. (Select “Trunk”->”Analog trunk”, and select the right type for “Call ID Start “and “Caller ID Signaling” in the editing page)

Note: In China, you can try only “Bell-USA” and “DTMF” for “Caller ID Signaling”.

It can be distinguished by configuring the “Distinctive Ringtone” in XonTel IP PBX Inbound Route settings. For detailed instructions, please refer to XonTel IP PBX user manual.

Note: this feature must interoperate with the IP phones. The brands that have been tested are Yealink and snom.

When the callback feature is enabled, the user could dial an inbound route number and hang up after hearing the ring back tone or wait to be hung up by the system automatically. Then XonTel IP PBX will call the user via the trunk. After the call is getting through, the user could dial the number he wants to call. If you would like enable the Callback feature, please configure as below:

Click “PBX”->“Advanced Settings”->“Callback Settings”, and “Add Callback Rule”, enter the number that is allowed to be called back, i.e. Callback Number. (e.g. 15960111111).

Click “PBX”-> “Inbound Routes”, and select “Yes” for “Enable Callback” in the Inbound Route editing page.

For example, in the above configuration, the trunk number is 5503301, and the user calls the number 5503301 via cell phone whose caller ID is 15960111111. After hearing the ring back tone, the user hang up the phone and XonTel IP PBX would call 15960111111 back via the trunk (5503301). Then the user could pick up the cellphone and dial the number he wants to call after hearing the prompt.

It is because of the mismatch of signaling. Please select “Trunk”->”Analog Trunk”, and change the value of “Caller ID Start” and “Caller ID Signaling” in the editing page.

Note: in most cases, the problem could be solved by changing the value of “Caller ID Start” from “Ring” to “Polarity”. But if not, please change it to other option.

Please add a new inbound route for this SIP trunk alone and define “DID number” to enable it match all DID numbers (i.e. define the DID number as “.” which will match any remaining digits).

If this SIP trunk has several DID numbers and different DID numbers called are supposed to be led to different destinations, please add different inbound routes for each of them. If the problem still exists after the configuration, please click “PBX”->“Advanced Settings” ->”SIP Settings”->”Advanced Settings” and change the value of “To Field” to “To”.

In this case, please check if the analog trunk has been selected in Inbound Routes.

If this trunk hasn’t been selected, please move it to the “Selected” box directly or add a new inbound route for it.

If this trunk has been selected in the right inbound route, the problem might be caused by the mismatch of signaling. Please select “Trunk”->”Analog trunk” and change the settings of “Caller ID Start” and “Caller ID Signaling”.

t can be realized by configuring the “Distinctive Ringtone” in XonTel IP PBX Inbound Route settings. For detailed instructions, please refer to XonTel IP PBX user manual.

Note: this feature must interoperate with the IP phones. The brands that have been tested are Yealink and Snom.

Solution No.1: click “PBX”->”Outbound Routes”, and set up password for the outbound route. In this way, all the selected extensions of this route must enter the password before making outbound calls.

Solution No.2: it can be realized by configuring PIN User. Click “PBX”->“Advanced Settings”->”PIN User Settings”, and add new PIN User. In the “Add PIN User” page, select the expected outbound routes and set up the PIN codes (not exclusive to one). In this way, the extension could make outbound calls only followed by entering the PIN code. In the settings of Figure 6-2, the extension 500 could first dial “*89” (default PIN User feature code), and enter “123” or “456” after hearing the prompt saying “please enter the PIN code”. When hearing the dialing tone, the user could make outbound calls.

After saving the change of settings, please don’t forget to click “Apply the changes” on the right corner of the page. Then 1-2 seconds later, the new settings could take effect.

Log in the Web Configuration Panel, and select “System Settings”->”System prompts” to change.

Note 1: If you select “Auto Detection” or “HTTP Download” as the Download Mode, please make sure that your device can access Internet first.

Note 2: If you select “TFTP” mode, please download the preferred system prompt first and then update it via TFTP server.

Download link of system prompt is as below

It’s because of the wrong “Date & Time” setting of the system. Please log in the Web Configuration Panel as the Admin, and click “System”->“System Preferences”->“Date and Time”. Adjust the time in the editing page.

It’s because that the device hasn’t been rebooted after the changes. Please reboot XonTel IP PBX after changing the time zone to make the new time take effect.

It’s because that XonTel IP PBX hasn’t been rebooted after changing the IP address. Please reboot the system and the problem would be solved.


Step 1: choose a Windows OS based PC as the Net-Disk server (note: only Windows OS is allowed).

Step 2: create a folder on this PC (e.g. folder name: share).

Step 3: create a text file named “status.txt” in the folder.

Step 4: share the folder and enable “permission of everyone to read and execute”.

Note: if your PC is Windows 7 OS based, please enable “permission of everyone to read and execute” and do not back up in C-disk.


The steps of configuring VPN settings are as below:

Step 1: in the Web Configuration Panel, select “System”->”VPN Settings”, and decide which VPN type you want to enable.

Step 2: click “Scan”, select the correct VPN configuration packet and click “Import”.

Step 3: reboot XonTel IP PBX.

Step 4: After rebooting, please select “Reports”->”System Info” to check if the VPN has been successfully connected. Once successfully enabled, the screen would show the status as “connected” with other information such as IP address.

Note: the VPN configuration packet should be in “*.rar” format.

  1. The packet should include all the keys and certificates of the VPN server and client, and the configuration files of the clients. All the information is supposed to be offered by VPN service provider. (The name of the *.rar file can only be composed of number, letter, “-”and “.”.)

  2. Because XonTel IP PBX is based upon UC Linux, all the VPN client configuration files should be in “*.conf” format (The Windows OS is using “*.ovpn” format.)

3) Please do not enable “user” and “group” in the client configuration files, or VPN could not be enabled successfully on XonTel IP PBX. Please configure as Figure 7-1 shows:

4) If your VPN cannot work well on XonTel IP PBX, please make sure it can work normally on your windows (Win2000/XP/Vista/7) or MAC OS. (Please note that if the VPN is running under Window 7 OS, it is required to use the mode that is compatible with Window XP OS and run as the administrator.)

Step 1: power off or unplug XonTel IP PBX.

Step 2: unscrew XonTel IP PBX and open the upper case.

Step 3: move the card slot towards the direction of the sign slightly (as Figure 7-2)

Step 4: insert the SIM card into the card slot (as Figure 7-3) and pull it down (as Figure 7-4).

Step 5: move the card slot back and lock the card (as Figure 7-5).










XonTel IP PBX S50



XonTel IP PBX S200