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:

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.

Phones management page

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.

Phones filters

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.

Phones 3 dot menu

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.

  1. Go to Admin > Advanced > Templates > Phone Templates tab.
  2. From the dropdown, choose your phone model and copy the template.
  3. 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>

  1. Now go to Add the phone in the users tab
  2. Select the custom template you just created:
  1. 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.
  2. 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

Last Updated

This document was last updated on 9 November 2026

https://www.3cx.com/docs/manual/ip-phones/