Skip to main content


Automatic Provisioning of Fanvil Phones

The PBX is able to automatically provision Fanvil desktop phones through zero-touch LAN provisioning, DHCP option 66 provisioning URL, and Fanvil RPS.

Supported Fanvil IP Phones

Fanvil Desktop PhonesLAN ProvisioningZero TouchEncryptionButtonsProvisioning

When provisioning a Fanvil phone, you should first set the required settings on the PBX as shown in provisioning document Steps Before Provisioning.

Reset X-Fanvil series Phone

To Factory reset a Fanvil phone make sure you in the main page of the phone. Press the OK button for about 10 seconds.


The phone will show you the Factory reset message, it will then reboot.


RPS Provisioning

If you're using the Vodia multi-tenant PBX you can acquire an RPS account from Fanvil here

You'll need to register first, Fanvil will then provide you with a user and password , you can it apply on the Vodia PBX. Under Admin -- Phone -- Settings --Fanvil

Once you have entered your credentials on the Vodia PBX save the configuration.


The older phone models (for e.g X4 etc.) need the as "Configuration File Name " as "prov/fanvil.txt " (will be found inside RPS --> Group --> Edit button --> Phone Flash section). The old models also may need multiple factory resets at each periodic interval during provisioning (Heads-up if you don't see the phone doing anything).

The newer phone models (for e.g. X4U etc.) need the as "Configuration File Name " as "prov/fanvil-sysconf.xml " (will be found inside RPS --> Group --> Edit button --> Phone Flash section)

In order for Fanvil's RPS to work, you will need to add the phones MAC address to the extensions. Vodia will then automatically register the device into your Fanvil RPS account.


In order for the PBX to securely provisioning the phone, you will need to open the MAC-based provisioning.
Navigate to your Domain ---> All Account ---> Extensions

Click on the extension box and under "Please select an action" choose Open account for MAC-based provisioning. This will set a time of 10-20 mins for that phone to provision to the PBX.


Reboot the Fanvil X device. The phone will contact Fanvils RPS, and send the phone to the Vodia PBX to get its the config file.

You should see the phone register.


Adding Buttons

To add Buttons to your phone, navigate to your Extension → Buttons. Vodia can detect any Fanvil model and button scheme. To add buttons to your phone, choose a type and parameter, once your done save.

Reboot the phone once, so it can fetch its new button config. For more information on Button check our buttons setup.

There is a special "Fanvil" mode where you can explicitly set the values for the XML files. Please use the parameter field to specifiy the values that should be sent in the format type=<type>;value=<value>;title=<title>;icon=<icon>, for example type=1;value=4006@1/ba*87;title=4006 Jim Demo;icon=Green.


Setup Devices In LAN

If your phone is in the same LAN as the PBX, you can provision the Fanvil devices by visiting the (Phones in the LAN) under the Administrator level (Phones→LAN Devices ).

Make sure the phone is factory reset (or at least has the default username and password). By default Vodia is listening on port 20 for device info, make sure it's not blocked. For more info on LAN provisioning visit LANP .


Make sure Steps Before Provisioning is completed before LAN provision. Continue and choose your Fanvil phone you want to provision and click on the setup button to assign the phone to one of your extensions.


Manual Setup of Provisioning Server

If you need to set the provisioning server manually for the device, you should use the path /prov/fanvil-sysconf.xml. For older models that do not properly support the XML provisioning and need ASCII-based provisioning please use the path /prov/fanvil.txt. You need to manually select the HTTP protocol. For the older models, it is also recommended to use the latest firmware in order to avoid problems with the provisioning.