Auto Provision Cisco SPA500 IP Phone with Yeastar P-Series Software Edition
This topic takes Cisco SPA502G (firmware: 7.6.2c) as an example to describe how to auto provision Cisco SPA500 IP phone with Yeastar P-Series Software Edition.
Requirements
| Model | Phone Requirement | PBX Requirement | Supported Auto Provisioning Method |
|---|---|---|---|
| SPA501G | 7.4.7 or later |
83.19.0.110 or later |
|
| SPA502G | 7.4.7 or later |
83.19.0.110 or later |
|
| SPA504G | 7.4.7 or later |
83.19.0.110 or later |
|
| SPA508G | 7.4.7 or later |
83.19.0.110 or later |
|
| SPA509G | 7.4.7 or later |
83.19.0.110 or later |
|
| SPA512G | 7.4.7 or later |
83.19.0.110 or later |
|
| SPA514G | 7.4.7 or later |
83.19.0.110 or later |
|
| SPA301 | 7.4.7 or later |
83.19.0.110 or later |
|
| SPA303 | 7.4.7 or later |
83.19.0.110 or later |
|
| SPA525G2 | 7.4.7 or later |
83.19.0.110 or later |
|
Scenarios
According to the network environment of Cisco IP phone and Yeastar PBX, you can auto provision IP phones using the PBX's built-in DHCP server or a third-party DHCP server, as the following table shows.
| Scenario | Description |
|---|---|
| IP Phone and PBX are in the SAME subnet | In this scenario, you can provision the Cisco IP phone using
the PBX built-in DHCP server to deliver a PBX-provided
provisioning link to the IP phone. In this way, the phone can
retrieve configurations from the PBX using the given link. Note: If there is already a DHCP
server running in the subnet, you can directly set up DHCP option 66 with
PBX-provided provisioning link on the
DHCP server.
For more information, see Auto provision a Cisco IP phone in the same subnet. |
| IP Phone and PBX are in DIFFERENT subnets (within the same LAN) or DIFFERENT networks | In this scenario, you can provision the Cisco IP phone using
DHCP option 66 of a third-party DHCP server to deliver a
PBX-provided provisioning link to the IP phone. In this way, the
phone can retrieve configurations from the PBX using the given
link. For more information, see Auto provision a Cisco IP phone in different subnets (within the same LAN) or different networks. |
Auto provision a Cisco IP phone in the same subnet
- Prerequisites
-
- Make sure that you have downloaded the template for the desired phone model (Path: ).
- Make sure that no DHCP server is active on the same subnet as the IP phone.
- RESET the IP phone if it is previously used.
- Gather information of IP phone, including Vendor, Model, and MAC address.
- Procedure
- Step 1. Set the PBX as a DHCP server
-
- Log in to PBX web portal, go to , click DHCP Server tab.
- Turn on the DHCP Server, and complete the
following network configurations.

- Gateway: Specify the IP address of the default gateway for the DHCP server.
- Subnet Mask: Specify the subnet mask used to subdivide your IP address.
- Preferred DNS Server: Specify a DNS server for the DHCP server.
- Alternative DNS Server: Optional. Specify a secondary DNS server for the DHCP server.
- DHCP Address Range: Specify the IP address range that will be allocated to DHCP clients.
- NTP Server: Enter the IP
address of an NTP server.Note: The default value is the IP address of the PBX, which can synchronize the network time of the client devices with the PBX.
- Click Save.
The Status field displays Running, indicating the DHCP server is running.

- Step 2. Add the Cisco IP phone on PBX
-
- On PBX web portal, go to .
- Click .
- In the IP Phone section,
enter the following phone information.

- Vendor: Select Cisco.
- Model: Select a phone model. In this example, select SPA502G.
- MAC Address: Enter the MAC address of the IP phone.
- In the Options section, configure the
following settings.

- Template: Select a desired template
from the drop-down list.Note: You can select the default template corresponding to the phone model, or customize your own template. For more information, see Create a Custom Auto Provisioning Template.
- Provisioning Method: Select
DHCP (In the Office).
A provisioning link is automatically generated and displayed in the Provisioning Link field. This provisioning link points to the location where the phone's configuration file is stored.
- Template: Select a desired template
from the drop-down list.
- In the Assign Extension
section, assign extension(s) to the phone, then specify which
extension's phonebook and function keys you want to use on the
phone.Tip: If your desired extension is not listed in the drop-down list of the Extension column, it indicates that the devices registered to the extension has reached the limit. You can use either of the following methods to proceed.
- To release the extension from the associated IP phone or gateway, see Release an Extension from a Provisioned IP Phone/Gateway.
- To raise the phone registration limit, you need to configure the concurrent registration setting for the extension, as the PBX only allows an extension to register with one SIP endpoint by default.
- To assign a single extension to the phone, select a desired
extension from the drop-down list beside
SIP1.
Both the Phonebook Line and Function Key Line fields are set to SIP1 by default, indicating that the phone will use the authorized phonebook(s) and function keys of the extension assigned to the SIP line 1.

- To assign multiple extensions to the phone, complete the
following settings.

- In the drop-down list beside SIP1, select a desired extension for SIP line 1.
- Click Add, then select a
desired SIP line and an extension for the added
entry.To assign more extensions to the phone, repeat this step.Note: The selected SIP lines must be supported by the phone, otherwise the configurations for unsupported SIP line will not be applied. You can check the phone's supported SIP lines via the phone webpage or on the device screen.
- In the Phonebook Line
drop-down list, select a SIP line. The phone book of
extension assigned to the SIP line will be applied
to the phone.Note: After successful registration, contacts are available regardless of which SIP line is currently active on the phone.
- In the Function Key Line
drop-down list, select a SIP line. The function keys
of extension assigned to the SIP line will be
applied to the phone.Note: After successful registration, the function keys take effect only when the selected SIP line is active on the phone.
- Click Save.
- Result
-
Note: Some IP phones will reboot automatically. If not, you need to manually reboot the phone to make the configurations take effect.
Auto provision a Cisco IP phone in different subnets (within the same LAN) or different networks
- Prerequisites
- Make sure that there is only one DHCP server running in the same subnet as the IP phone, or the IP phone would fail to obtain an IP address.
- RESET the IP phone if it is previously used.
- Gather information of IP phone, including Vendor, Model, and MAC address.
- Make sure that you have downloaded the template for the desired phone model (Path: ).
- Make sure that you have completed the corresponding settings
shown below according to the network environment of Cisco IP phone
and Yeastar PBX.
Network Environment Setting IP Phone and PBX are in DIFFERENT subnets (within the same LAN) - Make sure that the two subnets can communicates with each other.
- Enable the Remote Registration
feature for the extension (Path: ).

IP Phone and PBX are in DIFFERENT networks Remotely provision an IP phone using Yeastar FQDN - Grant remote SIP access permission for the
extension (Path: ).

Remotely provision an IP phone using public IP address / domain name - Configure PBX network for
remote access by a public IP address, by an external host domain name, or by a Yeastar domain name.Important: The following PBX ports MUST be forwarded for RPS provisioning.
- RTP ports
- SIP port
- Web Server port
- Complete the following settings
for the extension to be assigned to the IP
phone:
- Enable NAT for the extension (Path: ).

- Enable the Remote Registration
feature for the extension (Path: ).

- Enable NAT for the extension (Path: ).
- Procedure
- Step 1. Add the Cisco IP phone on PBX
Add the IP phone on PBX. The PBX will generate a configuration file based on the phone's MAC address.
- Log in to PBX web portal, go to .
- Click .
- In the IP Phone section,
enter the following phone information.

- Vendor: Select Cisco.
- Model: Select a phone model. In this example, select SPA502G.
- MAC Address: Enter the MAC address of the IP phone.
- In the Options section, configure the
following settings.

- Template: Select a desired template
from the drop-down list.Note: You can select the default template corresponding to the phone model, or customize your own template. For more information, see Create a Custom Auto Provisioning Template.
- Provisioning
Method: Select the provisioning method
according to your needs.
Provisioning Method Description DHCP (In the Office) Suitable for provisioning the IP phone that is located in different subnets within the same LAN. Provision Link (Remote) Suitable for provisioning the IP phone located in a remote network, and the IP phone will access the PBX using public IP address / domain name to retrieve configuration files. Provision Link - FQDN (Remote) Suitable for provisioning the IP phone located in a remote network, and the IP phone will access the PBX using Yeastar FQDN to retrieve configuration files. A provisioning link is automatically generated and displayed in the Provisioning Link field. This provisioning link points to the location where the phone's configuration file is stored.
Note: Note down the provisioning link, as you will use it later.
- Template: Select a desired template
from the drop-down list.
- In the Assign Extension
section, assign extension(s) to the phone, then specify which
extension's phonebook and function keys you want to use on the
phone.Tip: If your desired extension is not listed in the drop-down list of the Extension column, it indicates that the devices registered to the extension has reached the limit. You can use either of the following methods to proceed.
- To release the extension from the associated IP phone or gateway, see Release an Extension from a Provisioned IP Phone/Gateway.
- To raise the phone registration limit, you need to configure the concurrent registration setting for the extension, as the PBX only allows an extension to register with one SIP endpoint by default.
- To assign a single extension to the phone, select a desired
extension from the drop-down list beside
SIP1.
Both the Phonebook Line and Function Key Line fields are set to SIP1 by default, indicating that the phone will use the authorized phonebook(s) and function keys of the extension assigned to the SIP line 1.

- To assign multiple extensions to the phone, complete the
following settings.

- In the drop-down list beside SIP1, select a desired extension for SIP line 1.
- Click Add, then select a
desired SIP line and an extension for the added
entry.To assign more extensions to the phone, repeat this step.Note: The selected SIP lines must be supported by the phone, otherwise the configurations for unsupported SIP line will not be applied. You can check the phone's supported SIP lines via the phone webpage or on the device screen.
- In the Phonebook Line
drop-down list, select a SIP line. The phone book of
extension assigned to the SIP line will be applied
to the phone.Note: After successful registration, contacts are available regardless of which SIP line is currently active on the phone.
- In the Function Key Line
drop-down list, select a SIP line. The function keys
of extension assigned to the SIP line will be
applied to the phone.Note: After successful registration, the function keys take effect only when the selected SIP line is active on the phone.
- Click Save.
The IP phone is added and displayed in the Auto Provisioning phone list.
- Step 2. Configure DHCP option 66 on DHCP server
-
On the DHCP server in the same subnet as the IP phone, use the provisioning link obtained from Yeastar P-Series Software Edition to configure option 66 on the DHCP Server.
In this example, the configuration is shown below.

- Results
-
- After the IP phone is rebooted, it gets an IP address from the DHCP server, downloads the configurations from the PBX via the provisioning link, and applies the settings automatically.
- The extension is successfully registered on the IP
phone. You can check the extension registration status on on the PBX web portal.
Note: If the status displays
, this indicates that you assigned
multiple extensions to the IP phone but only some of them are
successfully registered on the phone. You can hover over
to view the registration status of
each extension.
- If multiple extensions are
successfully registered on the phone, corresponding SIP lines are
associated with different physical line keys on the device.
You can press a line key to activate the target SIP line. The corresponding indicator LED illuminates, and all calls are processed over this SIP line.