Provisioning Profiles
Provisioning is the fancy word for "getting a phone its settings automatically." Instead of typing account details into every handset by hand, the phone downloads a small configuration file from VoicerOnePBX when it powers on. This page explains how those files are built and how to customise them.
You set a DHCP option once (see Installation) so every phone learns where the PBX is. From then on, a new phone powers up, fetches its config, and — if you allow it — registers itself, all with no admin typing on the handset.
How a config is built
VoicerOnePBX generates each phone's configuration on demand, keyed by the phone's MAC address (a unique ID printed on the box and the back of the phone). The file contains the extension number, the SIP server address, the account password, and vendor-specific settings like line keys, time zone and the company phonebook.
Configs are built in layers, each overriding the one before it, so you can set something once for everyone and only override where needed:
- Global — defaults that apply to every phone (time zone, NTP, the directory).
- Vendor — settings for a whole brand (all Yealinks, all Polycoms).
- Model — settings for a specific model.
- Tag — settings for a group you define (e.g. "reception phones").
- Device — settings for one specific handset.
The override editor
Under Handsets → Device Provisioning you can add overrides at any of those layers, then Stage them (preview) and Push them to phones. The editor shows the effective, merged result so you can see exactly what a given phone will receive.
Changed something? Use the phone's card action Re-provision Phone. VoicerOnePBX sends the handset a "check-sync" notification that tells it to re-download its config immediately — no walking to the desk to power-cycle it.
Supported vendors
| Vendor | Method | Notes |
|---|---|---|
| Yealink | HTTP (:8080) | Full support incl. directory, wallpaper/logo and firmware. |
| Polycom / Poly (VVX) | HTTP | Per-MAC config + registration file, wallpaper and directory. |
| Grandstream (GXP / HT ATA) | HTTP | P-value XML config; HT-series analog adapters for fax machines. |
| Cisco (79xx) | TFTP | Needs a hand-built SEP<MAC>.cnf.xml and a licensed SIP firmware load. |
Firmware & self-healing
VoicerOnePBX can also serve firmware over HTTP, so a phone that shows up with the wrong or a factory (OEM) image can be pointed at the correct load and upgrade itself on the next provision.
Keeping provisioning secure
Config files contain SIP passwords, so provisioning is trusted to your local network. For anything beyond a single flat network, put phones on a dedicated voice VLAN and use the built-in source-IP allowlist (Device Provisioning → Security): list the subnets your phones live on and VoicerOnePBX will refuse to hand a config to anything outside them — even if it presents a known MAC address.
Automatic provisioning of brand-new, unknown phones is off by default. Leave it off and approve new devices manually (next page), or turn it on deliberately once your phone network is locked down.