The Autoprovisioning Plug & Play (PnP) technology is supported by many well-known phone manufacturers, such as Yealink and Snom. With the MikoPBX automatic phone setup module, you can quickly configure compatible phones, making them ready for use in the system. This greatly simplifies both the initial configuration and the ongoing support of phones in the office.
Simplifies initial setup – no need to connect to each phone's web interface for configuration. Instead, simply enter the device’s MAC address and assign it an account on the auto-setup server.
Eases support – centralized management of device settings makes it easy to adjust configurations for multiple phones from a single location.
Convenience for end users – in some cases, phones can be set up by dialing a short code, like *911*<SIP_ACC>. This is especially helpful for non-technical users who can configure the device themselves with a simple number combination.
The auto-setup module operates only within a local network.
Multicast requests to IP 224.0.1.75 must be allowed on the network.
Currently, only a single general registration address can be set for all devices.
Ports for the MikoPBX web interface (HTTP) and SIP (80 and 5060) must be open.
HTTPS is not supported in this version.
No other PnP servers should be running on the network since devices will accept settings from the first responding server.
Yealink T19(P)
Yealink T28(P)
Yealink W52
Yealink WP530
Snom D120
Snom D785
Snom D735
Snom D715
Snom D385
Snom D335
Fanvil X5U
Fanvil X3SP
Fanvil X1SP
We are working to expand the range of supported phone models.
Open the Modules -> Module Marketplace section.
Install the Automatic Phone Setup Module.
Note: Start the module only after completing all necessary settings.
After installing the module, open the settings page.
Extension Template – enter the extension number to use for quick phone setup via star code.
Server Registration Address – enter the IP address or domain of your MikoPBX server. Phones will connect to MikoPBX using this address.
Blacklist of MAC Addresses – enter MAC addresses of phones not to be set up. This allows you to exclude certain devices from auto-setup. The blacklist takes priority over the whitelist.
Whitelist of MAC Addresses – enter MAC addresses of phones that are authorized for auto-setup. If neither the blacklist nor the whitelist is specified, the module will attempt to configure all connected phones.
In the Additional Parameters field, you can enter custom settings that will be added to phone configuration files. Here are examples for each supported model.
By default, the server generates the following basic configuration file for Yealink phones:
To add extra parameters, use the [yealink] section in the Additional Parameters field. For example:
Each new parameter should be specified on a separate line.
The configuration file for Snom phones has a more complex XML structure. For example:
To add data in the <settings> node, use the [snom] section, and for the <phone-settings> node, use [snom-phone-settings].
Fanvil configuration files consist of separate modules. Here is an example of a basic configuration:
You can add extra parameters using the sections [fanvil], [fanvil-sip], [fanvil-tele], and [fanvil-autoupdate].
The first thing to check is whether your firmware version is up-to-date. Update the firmware if necessary from the Yealink support site.
Access the device’s web interface and navigate to Settings → Configuration.
Set the log level to the maximum value of 6.
Reboot the device and export the log.
In the downloaded log file, pay attention to errors, for instance:
If you see Connect Error, it means the phone was unable to download the configuration file from the server.