> For the complete documentation index, see [llms.txt](https://docs.pascom.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pascom.net/en/setup/endpoints/grandstream.md).
# Grandstream Desktop Phones
How to integrate your Grandstream IP Telephones in your PASCOM cloud phone system.
## Supported Endpoints
| Models | |
| -------------------- | -------------------- |
| Grandstream GXP 16XX | Grandstream GXP 17XX |
| Grandstream GXP 21XX | Grandstream GRP 26XX |
| Provisioning | Firmware Management | Desktop App CTI Control | PASCOM Menu |
| ------------ | ------------------- | ----------------------- | ----------- |
| yes | yes | yes | no |
**Provisioning**: The IP phone is managed via the PASCOM PBX web UI.\
**Firmware Management**: Firmware can be managed and updated via the PASCOM PBX web UI.\
**Desktop App CTI Control**: The Desktop App can remotely control the phone, i.e. to start calls.\
**PASCOM Menu**: A button on the phone will be assigned to access the PASCOM menu.
{% hint style="info" %}
Due to vast range of firmware versions available for the different IP telephones, it is not possible for us to test each version. Therefore, it could be the case that PASCOM does not support some firmware versions.
{% endhint %}
## Add New Phone
PASCOM cloud phone systems are able to automatically and centrally configure Grandstream IP phones. This process is known as Provisioning. For this purpose, PASCOM cloud phone systems include a Default Configuration (**Devices** > **Basic Configuration**). For most deployment scenarios, these standard settings provide an ideal configuration. However, in some cases, the settings may need to be modified.
### 1. Connect your Device
{% hint style="success" %}
Should the telephone not be factory new, ensure you perform a **factory reset**.
{% endhint %}
Connect the phone to your network. Snom IP phones come with a built in switch, allowing you to connect the phone directly via the Ethernet port labelled as **NET**. Should you not have a **PoE** option available, connect the phone to a power supply.
The Snom IP phone will now boot and acquires an IP address which is displayed on the screen during the boot process. Please take a note of this address.
### 2. Finding the MAC Address
MAC addresses can be found on the rear underside of the telephone.
Alternatively, using your browser, surf to the previously noted telephone's IP address.
Under **System Information** > **MAC-Address** please take a note of the phone's IP address.
### 3. Add Phones / Endpoints
Log into your PASCOM cloud phone system and under **Devices** > **Device list** and press **Add** and select the option **IP Telephone: Manufacturer Grandstream**.
Under the corresponding field, enter the **Mac-Address** that you have just found and noted.
### 4. Assigning Users
As soon as the IP phone has appeared in the Device List, it can be edited via the **Edit** button. Under the **Assign** tab, the phone can be assigned to a [user (or location)](/en/setup/user/user-concept.md)
### 5. Apply Jobs
After saving your phone setup configurations, a corresponding prompt to apply telephony configs will appear in the job box (top of the screen). Simply start the job by clicking on the **green tick**.
### 6. Finding the Provisioning URL
Select the desired telephone from the device list and under **Action** select the option **Provisioning URL**. Copy the **URL** to your clipboard.
### 7. Enter the Provisioning URL on the Telephone
Go to the Grandstream phone's admin UI, and enter the copied provisioning URL.
Click **Confirm** and finally **reboot**.
The phone will now restart and provision itself.
### 8. Function Testing
The simplest method of testing whether a device has been successfully deployed is to call ones Voicemail box via **\*100**. On successfully provisioned phones, you should now hear your Voicemail box prompts.
### Accessing the Grandstream Web UI
In order to access your telephone's web UI, you will need to know the phone's IP address. The following outlines the different methods of discovering the phone IP Address:
#### Finding the IP-Address on the Telephone
Press the round **OK** key in the center of the arrow keys. You can find the IP address via the **Status** > **Network Status** menu options.
#### Finding the IP-Address via the Web UI Device List
Log into the PBX Web UI and select the **Devices** > **Device list**, which provides you an overview of all available devices. To the left of each entry is an *Info* symbol which when clicked will open an overview of the provisioned telephone including the IP address.
### Programmable Keys
Via the Grandstream telephone's Web UI, it is possible to assign programmable function keys. Click on **Settings** > **Programmable Keys** and you will be able to configure the two types of keys available:
#### Virtual Multi-Purpose Keys
As programmable "soft keys", these keys appear on the phone's main display. In order to configure this key, click **Edit VPK**:
| Mode | Accounts | Description | Value |
| --------------------- | --------- | ---------------- | ---------------- |
| Busy Lamp Field (BLF) | Account 1 | Key label / name | Extension number |
To save your settings, simply click **Save**. The settings will then come into effect after clicking **Save VPK**.
{% hint style="info" %}
In order to reset the key settings, click on **Reset** and then finally **Save VPK**.
{% endhint %}
#### Multi-Purpose Keys
Depending on the IP telephone model, these keys are additional programmable "hard keys". Within the overview screen, you will see all the available multi-function keys which can be configured:
| Mode | Accounts | Description | Value |
| --------------------- | --------- | ---------------- | ---------------- |
| Busy Lamp Field (BLF) | Account 1 | Key label / name | Extension number |
To finish your configuration, click on **Save and Apply**, which will activate all your modifications.
{% hint style="info" %}
In order to reset the key settings, click on **Reset** and then finally **Save and apply**.
{% endhint %}
### Default Configuration
As previously stated, Grandstream IP phones are provisioned using the default configurations which can be found under **Devices** > **Basic Configurations**.
{% hint style="info" %}
When modifying the default configuration settings, ensure you make a duplicate copy of the original using the **Duplicate** tool.
{% endhint %}
In addition, you can set an already edited default configurations as the **standard settings**. Doing so ensures that all newly added IP telephones will automatically be provisioned with these default configurations.
#### Assigning a Default Configuration
A default configuration can be assigned using multiple methods:
* Via **Devices** > **Basic Configurations** > Choose your Basic configuration set and press **Edit** Under the **Devices** tab, it is possible to add multiple IP telephones.
* Via **Devices** > **Device list** > Select and edit the IP Telephone and under the tab **Basic Data** choose the correct **Basic configuration** option.
#### Automatic BLF Key Configuration via Basic Configurations
Under the **Configuration** tab, it is possible to modify the existing basic configuration.
Within the section, you can add your desired keys. The following example highlights how to add the first *Virtual-Multi-Purpose-Key*:
```
110Max103
```
#### Explanation:
**11** is the BLF key code **0** is the first account on the telephone **Max** is the label which should appear on the telephone screen **103** is the extension to be watched.
Via the menu tab **devices**, assign these default configurations to the telephones which should have this BLF configuration. Save and apply your changes and once the phones have restarted, the changes will have taken affect.
### Firmware Updates
From mobydick version 7.14 onwards, IP endpoint firmware will no longer be included as standard. Should a firmware version (other than the version pre-installed on the phone) be required, this must be externally sourced and per hand uploaded to the phone system firmware management tool.
#### Upload New Firmware
The desired firmware can be uploaded via the the **Devices** > **Device firmware**:
| Settings | Description |
| -------------- | -------------------------------- |
| Firmware Files | Upload the firmware files here. |
| Model | Grandstream Telephone model name |
| Version | Firmware Version |
| Comments | Optional field for notes |
#### Firmware Roll Outs
Firmware updates can be roll out via the **Devices** > **Device list** menu. Simply select the desired Grandstream Endpoints from the list via the check boxes and under **Actions** > **Roll out firmware**. This will open an overview of all selected devices to which the new firmware version should be roll out to. Click **Firmware Update** to roll out the desired firmware version.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.pascom.net/en/setup/endpoints/grandstream.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
