# Provision a Grandstream IP Phone with Cloud Voice Cloud Voice builds a configuration file for each Grandstream phone you register and serves it from a provisioning link. Point the phone at that link and it pulls down its settings and registers the assigned extension on its own. The examples below use a Grandstream GRP2602 (firmware 1.0.3.67), but the same steps apply to every supported model. ## Supported models and firmware Before you start, confirm that both the phone and your Cloud Voice system meet the minimum firmware levels for the model you are provisioning. | Model | Minimum phone firmware | Minimum system firmware | |-------|------------------------|-------------------------| | GAC2500 | 1.0.3.45 | 84.11.0.22 | | GAC2570 | 1.0.1.36 | 84.11.0.22 | | GHP610 | 1.0.1.71 | 84.18.0.18 | | GHP610W | 1.0.1.71 | 84.17.0.17 | | GHP611 | 1.0.1.71 | 84.18.0.18 | | GHP611W | 1.0.1.71 | 84.17.0.17 | | GHP620 | 1.0.1.71 | 84.18.0.18 | | GHP620W | 1.0.1.71 | 84.17.0.17 | | GHP621 | 1.0.1.71 | 84.18.0.18 | | GHP621W | 1.0.1.71 | 84.17.0.17 | | GHP630 | 1.0.1.71 | 84.18.0.18 | | GHP630W | 1.0.1.40 | 84.17.0.17 | | GHP631 | 1.0.1.40 | 84.18.0.18 | | GRP2601 | 1.0.3.63 | 84.9.0.18 | | GRP2601P | 1.0.3.63 | 84.9.0.18 | | GRP2602 | 1.0.3.63 | 84.9.0.18 | | GRP2602P | 1.0.3.63 | 84.9.0.18 | | GRP2602G | 1.0.3.63 | 84.9.0.18 | | GRP2602W | 1.0.3.63 | 84.9.0.18 | | GRP2603 | 1.0.3.63 | 84.9.0.18 | | GRP2603P | 1.0.3.63 | 84.9.0.18 | | GRP2604 | 1.0.3.63 | 84.9.0.18 | | GRP2604P | 1.0.3.63 | 84.9.0.18 | | GRP2612 | 1.0.7.25 | 84.9.0.18 | | GRP2612P | 1.0.7.25 | 84.9.0.18 | | GRP2612G | 1.0.7.25 | 84.9.0.18 | | GRP2612W | 1.0.7.25 | 84.9.0.18 | | GRP2613 | 1.0.7.25 | 84.9.0.18 | | GRP2614 | 1.0.7.25 | 84.9.0.18 | | GRP2615 | 1.0.7.25 | 84.9.0.18 | | GRP2616 | 1.0.7.25 | 84.9.0.18 | | GRP2624 | 1.0.7.25 | 84.9.0.18 | | GRP2634 | 1.0.7.25 | 84.9.0.18 | | GRP2670 | 1.0.7.25 | 84.9.0.18 | | GXP1610 | 1.0.7.13 | 84.9.0.18 | | GXP1620 | 1.0.7.13 | 84.9.0.18 | | GXP1625 | 1.0.7.13 | 84.9.0.18 | | GXP1628 | 1.0.7.13 | 84.9.0.18 | | GXP1630 | 1.0.7.13 | 84.9.0.18 | | GXP2130 | 1.0.11.16 | 84.9.0.18 | | GXP2135 | 1.0.11.16 | 84.9.0.18 | | GXP2140 | 1.0.11.16 | 84.9.0.18 | | GXP2160 | 1.0.11.16 | 84.9.0.18 | | GXP2170 | 1.0.11.16 | 84.9.0.18 | | GXW4216 | 1.0.23.4 | 84.6.0.24 | | GXW4224 | 1.0.23.4 | 84.6.0.24 | | GXW4232 | 1.0.23.4 | 84.6.0.24 | | GXW4248 | 1.0.23.4 | 84.6.0.24 | | HT801 | 1.0.63.3 | 84.6.0.24 | | HT802 | 1.0.63.3 | 84.6.0.24 | | HT812 | 1.0.5.10 | 84.6.0.24 | | HT814 | 1.0.63.3 | 84.6.0.24 | | HT818 | 1.0.63.3 | 84.6.0.24 | | WP825 | 1.0.11.67 | 84.17.0.17 | ## Provisioning scenarios How you deliver the provisioning link depends on how many phones you are setting up: - **A single phone**: Enter the link on the phone yourself, in its web interface. See [Provision a single phone manually](#provision-a-single-phone-manually). - **Several phones at once**: Publish the link through DHCP (Dynamic Host Configuration Protocol) option 66 so every phone in the subnet picks it up automatically. See [Provision multiple phones automatically](#provision-multiple-phones-automatically). Both paths start the same way: you register the phone in Cloud Voice so a configuration file and link are generated for it. ## Provision a single phone manually ### Before you begin - Add the default provisioning template for your phone model under **Auto Provisioning > Resource Repository > Default Templates**. - If the phone was in service before, reset it to factory defaults so old settings do not interfere. - Have the phone's vendor, model, and MAC (Media Access Control) address on hand. The MAC address is the phone's unique hardware identifier, usually printed on a label on the underside of the unit. ### Step 1: Add the phone in Cloud Voice Registering the phone tells Cloud Voice to build a configuration file keyed to its MAC address. 1. Sign in to the management portal and go to **Auto Provisioning > Phones**. 2. Click **Add > Add**. 3. In the **IP Phone** section, identify the device: ![Add phone form with the vendor, model, and MAC address fields](/images/pbx/add-gs-phone.png) - **Vendor**: Choose **Grandstream**. - **Model**: Choose the phone model. This example uses **GRP2602**. - **MAC Address**: Type the phone's MAC address. 4. In the **Options** section, set the provisioning behavior: ![Cloud Voice, provisioning options showing the template and the generated provisioning link](/images/pbx/gs-option-cloud.png) - **Template**: Pick a template from the list. Use the default template that matches the phone model, or a custom template you have built. - **Provisioning Link**: Cloud Voice generates this link and points it at the phone's configuration file. Copy it down now, because you will paste it onto the phone in the next step. 5. In the **Assign Extension** section, select the extension to bind to this phone. ![Assign extension drop-down for the new phone](/images/pbx/assign-an-extension-pnp.png) :::tip If the extension you want is missing from the list, it is already tied to another phone. You can either release it from that device first, or enable concurrent registration on the extension so it can register to more than one endpoint. By default, an extension registers to a single SIP (Session Initiation Protocol) endpoint only. ::: 6. Click **Save**. ### Step 2: Point the phone at the provisioning server Enter the Cloud Voice provisioning link in the phone's own web interface. 1. Log in to the Grandstream phone's web interface: ![Grandstream phone web login page](/images/pbx/log-into-grandstream.png) 1. Type the phone's IP address in your browser's address bar. 2. Enter the user name `admin` and its password. 3. Click **Login**. 2. In the left navigation bar, go to **Maintenance > Upgrade and Provisioning > Config File**. ![Config File page under Upgrade and Provisioning](/images/pbx/pce-autop-config.png) 3. In the **Configure via Network** section, enter the provisioning server details: ![Cloud Voice, Configure via Network fields for the upgrade method and config server path](/images/pbx/pce-autop-config-file-1.png) - **Config Upgrade via**: Select **HTTPS**. - **Config Server Path**: Paste the provisioning link you copied from Cloud Voice. :::caution Strip the `https://` prefix from the link before you paste it into **Config Server Path**. The scheme is already set by the **Config Upgrade via** field. ::: 4. Click **Save and Apply**. ### Result :::note Many Grandstream phones reboot on their own after applying the settings. If yours does not, reboot it manually so the changes take effect. ::: - Once the phone restarts, it downloads its configuration from Cloud Voice and applies the settings automatically. - The assigned extension registers on the phone. Confirm the registration state under **Auto Provisioning > Phones** in the portal. ![Phones list showing the Grandstream device with a registered extension](/images/pbx/gs-autop-cloud.png) ### What to do next Grandstream phones enable every available codec on an account by default, which can interfere with outgoing calls. Trim the account down to the codecs you actually use. See [Remove Unnecessary Codecs for Grandstream IP Phone](/pbx/ip-phone-configuration-guide/remove-unnecessary-codecs-for-grandstream-ip-phone/). ## Provision multiple phones automatically Instead of touching each phone, you register them all in Cloud Voice and hand the provisioning link to the subnet through DHCP option 66. Every phone that boots on that subnet reads the link, fetches its configuration, and registers. ### Before you begin - Make sure the subnet has only one DHCP server, or the phones may fail to obtain IP addresses. - Add the default provisioning template for your phone model under **Auto Provisioning > Resource Repository > Default Templates**. - Reset any phone that was in service before to factory defaults. - Have each phone's vendor, model, and MAC address on hand. ### Step 1: Add each phone in Cloud Voice Register every phone as described in [Step 1 of the manual procedure](#step-1-add-the-phone-in-cloud-voice): set the vendor, model, and MAC address, choose a template, assign an extension, and save. Cloud Voice generates a configuration file and provisioning link for each device. ### Step 2: Set DHCP option 66 :::note DHCP option 66 is the field a DHCP server uses to hand out the address of a provisioning server. When a phone leases its IP address, it also reads this field, so it learns where to fetch its configuration without you touching the phone directly. ::: 1. In the portal, open a phone's detail page and copy its provisioning link. ![Cloud Voice, phone detail page with the provisioning link to copy](/images/pbx/gs-autop-link-cloud.png) 2. On your DHCP server, configure option 66 with that provisioning link. The example below shows a typical setup: ![Cloud Voice, DHCP server with option 66 set to the provisioning link](/images/pbx/gs-dhcp-setting-pce.png) ### Result :::note Many Grandstream phones reboot on their own after applying the settings. If one does not, reboot it manually so the changes take effect. ::: - After a phone restarts, it leases an IP address from the DHCP server, downloads its configuration from Cloud Voice through the provisioning link, and applies the settings automatically. - The assigned extension registers on the phone. Confirm the registration state under **Auto Provisioning > Phones** in the portal. ![Phones list showing the Grandstream device with a registered extension](/images/pbx/gs-autop-cloud.png) ### What to do next Grandstream phones enable every available codec on an account by default, which can interfere with outgoing calls. Trim each registered account down to the codecs you actually use. See [Remove Unnecessary Codecs for Grandstream IP Phone](/pbx/ip-phone-configuration-guide/remove-unnecessary-codecs-for-grandstream-ip-phone/).