You have two options to get your phone to be provisioned:
- Set up a DHCP server
- Tell manually each phone where to get the provisioning informations
You may want to manually configure the phones if you are only trying Wazo or if your network configuration does not allow the phones to access the Wazo DHCP server.
You may want to set up a DHCP server if you have a significant number of phones to connect, as no manual intervention will be required on each phone.
Configuring the DHCP Server¶
Wazo includes a DHCP server that facilitate the auto-provisioning of telephony devices. It is not activated by default.
There’s a few things to know about the peculiarities of the included DHCP server:
- it only answers to DHCP requests from supported devices.
- it only answers to DHCP requests coming from the VoIP subnet (see network configuration).
This means that if your phones are on the same broadcast domain than your computers, and you would like the DHCP server on your Wazo to handle both your phones and your computers, that won’t do it.
The DHCP server is configured via
The installation and management of
provd plugins is done via
If you uninstall a plugin that is used by some of your devices, they will be left in an unconfigured state and won’t be associated to another plugin automatically.
It’s possible there will be more than 1 plugin compatible with a given device. In these cases, the difference between the two plugins is usually just the firmware version the plugins target. If you are unsure about which version you should install, you should look for more information on the vendor website.
It’s good practice to only install the plugins you need and no more.
Alternative plugins repository¶
By default, the list of plugins available for installation are the stable plugins for the officially supported devices.
This can be changed with
http://provd.wazo.community/plugins/1/stable/– community supported devices “stable” repository
http://provd.wazo.community/plugins/1/testing/– officially supported devices “testing” repository
http://provd.wazo.community/plugins/1/archive/– officially supported devices “archive” repository
The difference between the stable and testing repositories is that the latter might contain plugins that are not working properly or are still in development.
The archive repository contains plugins that were once in the stable repository.
After setting a new URL, you must refresh the list of installable plugins with
How to manually tell the phones to get their configuration¶
If you have set up a DHCP server on Wazo and the phones can access it, you can skip this section.
The according provisioning plugins must be installed.
On the web interface of your phone, go to, and enter the following settings:
On the phone, go toand enter the following settings:
- Server type: HTTP
- Server address:
http://<Wazo IP address>:8667/000000000000.cfg
Then save and reboot the phone.
First, you need to run the following command on the Wazo server:
sed -i 's/dhcp:stop/dhcp:proceed/' /var/lib/wazo-provd/plugins/xivo-snom-126.96.36.199/var/tftpboot/snom-general.xml
On the web interface of your phone, go toand enter the following settings:
Autoprovisioning a Device¶
Once you have installed the proper provd plugins for your devices and setup correctly your DHCP server, you can then connect your devices to your network.
GET /devices. You will then see that no devices are currently known by your Wazo
You can then power on your devices on your LAN. For example, after you power on an Aastra 6731i and
give it the time to boot and maybe upgrade its firmware, you should then see the phone having its
first line configured as ‘autoprov’, and if you
GET /devices, you should see that your
Wazo now knows about your 6731i with
You can then dial from your Aastra 6731i the provisioning code associated to a line of one of your user.
You will hear a prompt thanking you and your device should then reboot in the next few seconds.
Once the device has rebooted, it will then be properly configured for your user to use it. And also,
GET /devices, you’ll see the device with with
Resetting a Device¶
From REST API¶
To remove a phone from Wazo or enable a device to be used for another user: possibilities :
The phone will restarts and display autoprov, ready to be used for another user.
From a Device¶
- Dial *guest (*48378) on the phone dialpad followed by xivo (9486) as a password
The phone restarts and display autoprov, ready to be used for another user.