This guide covers the automatic provisioning feature in the PBX portal, for Yealink phones. Please note that auto-provisioning of non-Yealink phones is not supported at this point in time.

This feature will allow a phone on a given MAC address to be automatically configured as a SIP device on your account. On boot-up, the phone will check for configuration and automatically download, the configuration securely from the provisioning server. To configure automatic device provisioning, you will require the phones MAC address and model number.


Locating the MAC address and model number

The MAC address is a unique network identifier for each device. You can find the MAC address in two different ways: If you log into the phone web interface, you can find the details on the Status tab under Network Common. Please note that if you're using Wi-Fi on a Wi-Fi compatible Yealink device, you'll need to use the Wi-Fi MAC address. 


You can also find the MAC address by looking at the lower part of the back of the device. There will be two bar-codes, one of which will be labelled MAC. 

The next thing needed is the model number. This can be found be looking at the black label on the back next to the bar-codes.


For cordless users: The MAC address and model number you need is the Base station's, not the individual handsets. The MAC and model no. can be found on the bottom of the base station. Alternatively you can find the required details on the base station's web interface under the section pictured above.


Configuring automatic device provisioning from the PBX portal

Once the MAC address and device model are located, the next step is to configure provisioning on the web portal. On the PBX tab, click on SIP devices in the bottom left corner of the page to bring up the full list of SIP devices. 


Select the SIP device you would like to configure for auto-provisioning and click the Show advanced button to reveal various settings. Towards the bottom of the list of settings, you will be able to locate the MAC address and Device model fields. Once located you will need to enter in the MAC address and select your model number from the drop down menu, of your handset you wish to configure, for automatic provisioning.



As soon as a device model has been selected from the drop down list, a new field will appear called Additional CFG config. This field is for configuring non-standard settings such as BLF keys, global phonebooks and more. 

Without adding any additional configuration to this field, the auto provisioning system will configure the username, register name, display name, password, time settings, registration port number, server expiry, and STUN settings.


Custom tags for advanced configurations

The additional configuration section allows you to add BLF keys, phonebooks, additional SIP accounts, and anything else that may be required apart from the default settings. This section requires knowledge of the Yealink tags. You can download a sample .cfg file from the Yealink website which contains a full list of possible configuration options, which can be used in the additional cfg config section.

If you navigate to the you'll see a long list of phones. Select your phone model from there and look for the AutoProvisioning Template .zip file under the Other Documents section. The MAC.CFG file and common.cfg files within the .zip archive contain various configuration settings. See the below example of two BLF keys, configured for buttons 1 and 2.


Similarly, for a remote phonebook configuration, you can use the settings below, with your unique remote global phonebook URL.


There are various other options that can be set up for remote provisioning as well, we recommend investigating Yealink's documentation guides around automatic provisioning for more advanced configurations. 

Device password security

Below the additional CFG config section, there is a checkbox reading Set custom passwords for device. Enabling this option creates a prompt for user and admin passwords, for the web interface. We recommend setting complex passwords here, or un-checking and leave as the default, we do not recommend leaving the passwords in the default state. On top of this, you may want to consider using a random password generator such as


Forcing the device to send a automatic provision request

By default, the Yealink phone will automatically look for a provisioning server on boot-up. However, the phone can be configured to auto-provision at varying frequencies or can manually update configuration via auto-provisioning at any time. To configure this option on the device, login via the web browser, locate the Settings tab and select Auto Provision.

Inside the Auto Provision section of the Yealink web interface, you will find various timers to configure automatic provisioning for specific weekdays, times, and there will be an Auto Provision Now button to force the phone to auto provision immediately. Please note that if the timers are set in the web interface, and the auto provisioning configuration file inside the PBX does not include the same details, as the handset, you may find those settings are lost when the phone has been re-provisioned


You can also export the CFG configuration file from the Yealink device web interface. In order to complete the export, login to the web interface, select the Settings tab and locate the Configuration menu. Open the exported CFG file in a plain text editor and copy the settings from that .CFG file into the additional CFG config field inside the PBX web portal.