# Manually Provision an IP Phone

Manual provisioning links a physical IP (Internet Protocol) phone to Cloud Voice in two stages: you register the handset and its extension in the management portal, then tell the phone where to fetch its configuration. The steps below use a Grandstream GRP2602 running firmware 1.0.3.67 as the example, but the same process applies to any supported Grandstream model.

:::note
This page covers provisioning a phone for a single user's extension. To share one phone among several users via auto provisioning, see [Set up a Hot Desking Phone](/pbx/administrator-guide/set-up-a-hot-desking-phone/).
:::

## Supported IP phones

These steps apply to the Grandstream models listed under [Auto Provisioning - Supported Devices](/pbx/administrator-guide/cloud-auto-provisioning-supported-devices/#cloudpbx-auto-provisioning-supported-devices__grandstream).

## Before you start

- Confirm the [default template](/pbx/administrator-guide/update-a-default-auto-provisioning-template/) for your phone model has already been downloaded. You can find templates under **Auto Provisioning > Resource Repository > Default Templates**.
- Have the phone's details on hand: vendor, model, and MAC address (Media Access Control, the phone's unique hardware address, usually printed on a label on the phone or its box).
- If the phone was used previously, reset it to factory defaults first.

  :::caution
  A factory reset erases all of the phone's current settings, including any extension it was already registered to. Only reset a phone you are certain is no longer in use.
  :::

## Step 1: Register the phone's MAC address in Cloud Voice

1. Sign in to the Cloud Voice management portal and go to **Auto Provisioning > Phones**.
2. Click **Add**.
3. Under **IP Phone**, identify the handset:

   ![Auto provisioning form with vendor, model, and MAC address fields](/images/pbx/pce-autop.png)

   - **Vendor**: Choose the manufacturer. For this example, select **Grandstream**.
   - **Model**: Choose the model. For this example, select **GRP2602**.
   - **MAC Address**: Enter the phone's MAC address.
4. Under **Options**, set the provisioning details:

   - **Template**: Pick a template from the drop-down list.

     :::note
     A template supplies every setting except the extension assignment. Use the default template that matches your phone model, or build your own, see [Create a Custom Auto Provisioning Template](/pbx/administrator-guide/create-a-custom-auto-provisioning-template/).
     :::
   - **Provisioning Link**: Cloud Voice generates a provisioning server URL automatically and shows it on the page.

     :::note
     Copy this provisioning link somewhere handy. You'll paste it into the phone in Step 2.
     :::
5. Under **Assign Extension**, select the extension to bind to this phone.

   :::tip
   If the extension you want isn't in the drop-down, it's likely already tied to another phone or gateway. You can either [release it from the other device](/pbx/administrator-guide/release-an-extension-from-a-provisioned-ip-phone-or-gateway/) or [allow the extension to register on multiple phones](/pbx/administrator-guide/allow-multiple-registrations-for-one-extension-number/).
   :::
6. Click **Save**. Cloud Voice builds a configuration file for the phone.

## Step 2: Point the phone at the provisioning server

1. Open the phone's web interface by browsing to its IP address and signing in.
2. In the left navigation, go to **Maintenance > Upgrade and Provisioning > Config File**.

   ![Config File page in the phone's maintenance menu](/images/pbx/pce-autop-config.png)
3. In the **Configure via Network** section, enter the server details:

   
   ![Cloud Voice, Configure via Network fields for the provisioning server](/images/pbx/pce-autop-config-file-1.png)

   1. Provide the provisioning server information:
      - **Config Upgrade via**: Select **HTTPS** (Hypertext Transfer Protocol Secure, the encrypted method the phone uses to fetch its configuration).
      - **Config Server Path**: Paste the provisioning link you copied from Cloud Voice.

        :::caution
        Delete the leading `https://` from the link before pasting it into this field. The protocol is already set separately in **Config Upgrade via**, so leaving the prefix in place breaks the download.
        :::
   2. Click **Save and Apply**.

## Result

- Back in the portal under **Auto Provisioning > Phones**, the phone's registration status shows whether the assigned extension has come online:

  - ![Registered status icon](/images/pbx/registered.png), The extension is registered on the phone.
  - ![Unregistered status icon](/images/pbx/unassigned.png), The extension is not registered on the phone.

  ![Phones list showing a successfully provisioned handset](/images/pbx/pce-autop-success.png)
- From now on, the phone pulls its configuration file from Cloud Voice automatically and applies those settings whenever it provisions.