Configuring IP Phones
On this topic:
Introduction
3CX automatically configures supported deskphones and lets administrators manage them from the Admin Console. A phone retrieves its settings from a secure provisioning link delivered through one of the methods below. For local or SBC-assisted discovery and assignment, see PnP Phones. To add a phone to a user or configure an unsupported phone manually, see Creating Users / Extensions. For DECT deployments, see Configuring a DECT Phone.
- RPS - This is the easiest way - works for both cloud and on premise installs. The phone is pre-programmed from the factory to connect to the vendor's RPS server and request the provisioning URL. 3CX sends the vendor's RPS server the URL and when a new phone boots up it will obtain the URL from the RPS server.
- PnP - The phone sends a broadcast message which is picked up by the 3CX server which then shows the phone in the Admin console. You can then assign the phone to an extension. It works for on premise installs as well as installs with at least one phone connected via SBC in the same location. To assign a discovered phone, go to Admin > Phones > PnP Phones, select the phone and click Assign. Choose the Phone Model (built-in or custom template), then the user. Read more here.
- DHCP option 66 - For larger networks with managed DHCP servers, you can enter the base URL in DHCP Option 66. A phone will query this field when it obtains its IP and if a URL is specified it will go there by adding its MAC address. This option makes sense for larger networks. However it requires that the phones are all from the same vendor because vendors use different URL formats. See this document about Option 66 for more information.
Note: From V20 Update 10, the 4SC FREE and 3CX SMB Editions do not allow adding IP phones, assigning phones through PnP or adding Hot Desking phones. Upgrade to an edition that supports IP phones to use these options.
Why Router Phones (SBC)?
If 3CX is hosted in the cloud, you need to have at least one so-called "router phone", or an SBC in the network on which the IP Phones are located.
A router phone is nothing other than a normal IP phone which runs the 3CX SBC onboard. 3CX has provided its SBC code to leading IP vendors (Fanvil, Snom, Yealink) who have ported the code to their more powerful phones. This router phone will proxy all the voice traffic to your hosted 3CX and:
- Encrypt all voice traffic for security.
- Reconnect calls in case of drop out.
- Combine SIP (signaling) and RTP (media) VoIP Packets to overcome firewall/networking issues.
- Save bandwidth by setting up internal calls between local phones directly.
A router phone can also function as a normal phone. The following models can be configured as router phones:
- Fanvil V64, V65, V62, X4U-V2, X5U-V2, X6U-V2, X7-V2, X7C-V2, X210-V2 and X210i-V2
- Snom D862, D865
- Yealink T53, T53C, T53W, T54W, T57W
- See the latest list of router phones here
Alternatively, for larger networks, you can install a dedicated SBC. To install a 3CX SBC on Windows, Debian or a Raspberry Pi, read this document.
IP Phone Management
Managing phones
Open Admin > Phones to manage configured deskphones and hot-desking phones. The page combines device inventory, connection status and operational actions in one list.
The table shows the user, extension and department; MAC and registered IP address; connection path; configured model; current and assigned firmware; and any applicable action. A green status indicator means registered and red means not registered. When a phone is not registered, IP and Current Firmware are blank.
Use the search field to match an extension, user name, MAC address, IP address, model, firmware or SBC/router phone. Open the filter to narrow the list by Status, Firmware Source, Department or SBC, and use Show Only for Outdated FW, Router Phones, IP Phones or DECT Phones.
Select one or more phones to enable actions supported by every selected device:
- Reboot - Restarts the selected registered phone(s).
- Reprovision - Requests the latest 3CX-generated configuration. Use it after PBX-wide data changes, such as a phonebook update; user and phone configuration changes normally trigger reprovisioning automatically.
- Firmware actions - Upgrade Firmware, Choose Different Firmware and Clear Firmware are covered in IP Phone Firmware Management. The firmware library at Admin > Phones > Firmware contains 3CX Firmware and uploaded Vendor Firmware. One file is marked Preferred for each vendor and model and serves as its default update target.
Open the three-dot menu for a single phone:
- Edit User - Opens the user's IP Phone configuration.
- Move Phone - Assigns the provisioned phone to another user while keeping its phone configuration and related router-phone dependencies.
- Switch Template - Changes the provisioning template used to generate the phone configuration.
- View Configuration - Shows the configuration 3CX will provide at the next provisioning cycle; it may not match settings currently active on the phone until the device reprovisions.
- IP Phone Details - Shows status, user, model, MAC and IP, web-console credentials, and RPS status with Resend RPS or Revoke RPS when available.
Action availability depends on phone type, provisioning state, registration and connection. Use Firmware for firmware library and assignment, PnP Phones for discovery and assignment, Hot Desking Phones for shared devices, and Options for PBX-wide behavior.
IP Phone Options
Open Admin > Phones > Options to configure PBX-wide IP phone behavior. The page contains the following sections:
- Provisioning - Use 3CX RPS to provision phones over local LAN, STUN, SBC and router-phone connections. You can also secure provisioning files with unique keys; disable this only when using DHCP Option 66.
- IP Phone Firmware - Use "Update phones when they're first provisioned" for new phones and "Keep existing phones up to date on a schedule" for existing phones. Scheduled updates can run weekly or monthly. See IP Phone Firmware Management for firmware assignment, preferred firmware and scheduling details.
- Reassign DND Button - Reassign the phone's default DND button to a 3CX profile status, then select the status the button should apply.
- IP Phone Directory Update - Set how often Fanvil, Yealink, Snom and Grandstream phones refresh the 3CX directory. Shorter intervals propagate changes faster; longer intervals reduce network traffic. Fanvil and Grandstream use minutes; Yealink and Snom use seconds.
- Configure Queue Ringtones - Use one default ringtone for all queues, or allow agents to configure a distinctive ringtone for each queue. Queues without a custom ringtone use the default ringtone for calls.
Accessing the IP phone UI
3CX generates a unique username and password for each managed IP phone. Go to Admin > Users, select the assigned user and open IP Phone. Click Web Console URL and sign in using the Web Console Username and Web Console Password shown on that page. This is the web-console link location for PBXs hosted in your own cloud or by 3CX.
On on-premises PBXs, the following web-interface links are available for phones configured to connect over the local LAN:
- Admin > Phones > phone’s three-dot menu > IP Phone Details > Open Device Web Interface.
- The discovered phone’s three-dot menu under Admin > Phones > PnP Phones.
Access depends on the network path; a phone behind an SBC or router phone may not be directly reachable.
Advanced Provisioning Options
Provisioning a phone with STUN (not recommended)
If you wish to use STUN, then you must create a custom template. You can then enable STUN in this template and select it when you add an IP Phone for a user.
- Go to Admin > Advanced > Templates > Phone Templates tab.
- From the dropdown, choose your phone model and copy the template.
- Now look for the entry <AllowedNetworkConfig> and do the following;
<AllowedNetworkConfig>
<option value="LOCALLAN">0</option>
<option value="REMOTESTUN">1</option>
<option value="SBC">0</option>
</AllowedNetworkConfig>
- Now go to Add the phone in the users tab
- Select the custom template you just created:
- If 3CX RPS OFF - You will get a dialog showing the provisioning link you have to enter into the phone, using either DHCP 66 or by logging in to the phone interface.
- If 3CX RPS ON - we create a 3CX RPS event and reboot the phone.
We do not recommend using STUN and you will not receive any support from 3CX, either in the forum or via a ticket.
Turning off RPS - using Local IP
By default the V20 setup provisions phones securely on the local LAN via RPS and publishes provisioning information to the 3CX RPS server. If you don't want to use RPS, you can switch off RPS by going to Phones > Options.
See also
- Add an IP phone to a user or configure it manually in Creating Users / Extensions.
- Discover and assign phones on the local or SBC network with PnP Phones.
- Configure a DECT phone and assign handsets with Configuring a DECT Phone.
- Manage phone firmware, update policies and assignments in IP Phone Firmware Management.
- See our list of supported IP phones and DECT phones.
- How to configure Hot Desking with 3CX and use the same IP Phone for multiple users.
- Setting up a TFTP server for firmware updates.
- How to Auto-Provision IP Phones with the DHCP "Option 66"
- How to configure the BLF buttons
- IP Phone configuration guides for:
- Fanvil V62, V64, V65
- Fanvil X and XU series: X210, X7, X6, X5, X4, X3, X2, X1
- Snom D862, D865
- Snom M300, M400, M900 (DECT phone)
- Yealink T53, T53C, T53W, T54W, T57W
- Yealink W70, W80, W90 (DECT phone)
Last Updated
This document was last updated on 9 November 2026
