/* BEGIN BLOG-CLOSE-CHAT */ /* END BLOG-CLOSE-CHAT */

Devices

Super AdminTenant Admin

The Devices module lets you register SIP desk phones, ATA adapters, and other hardware endpoints in ICTPBX. You store the device’s MAC address and link it to an extension, which enables zero-touch provisioning for supported phone models.

ICTPBX device list

Adding a Device

  1. Go to PBX › Devices
  2. Click Add Device
  3. Enter the MAC address of the phone (found on the label on the bottom of the device)
  4. Select the extension to assign this device to
  5. Fill in any provisioning parameters required for your phone model
  6. Click Save

ICTPBX add device form
ICTPBX device edit form

For zero-touch provisioning, point your phone’s auto-provisioning server URL to your ICTPBX portal. The phone fetches its config on first boot using the MAC address you registered.

How Zero-Touch Provisioning Works

Zero-touch provisioning removes manual phone configuration. Instead of typing SIP credentials into every handset, you register the device once in ICTPBX and let the phone configure itself. The flow looks like this:

  1. You add the phone’s MAC address in PBX › Devices and link it to an extension
  2. The phone is told where your provisioning server lives (its auto-provisioning URL)
  3. On boot, the phone requests its configuration file, identified by its MAC address
  4. ICTPBX returns the SIP account settings for the linked extension
  5. The phone applies the config and registers, ready to make and receive calls

Swapping a broken handset becomes a two-minute job: update the MAC address on the device record, plug in the new phone, and it picks up the same extension.

Pointing the Phone at Your Provisioning Server

There are two common ways to hand the provisioning URL to a phone:

  • Per phone, through its web interface. Open the phone’s admin page, find the auto-provisioning or config server setting, and enter your ICTPBX portal’s provisioning URL. Fine for a handful of phones.
  • Fleet-wide, through DHCP. Configure your DHCP server to advertise the provisioning URL (most phones read Option 66, some vendors use Option 43). Every factory-reset phone on that network then finds the server on its own. This is the right approach for offices with many handsets.

Example: Grandstream Desk Phones

  1. Log in to the phone’s web interface
  2. Go to Maintenance › Upgrade and Provisioning
  3. Set the config server path to your ICTPBX provisioning URL and select HTTP or HTTPS as the upgrade method
  4. Save and reboot the phone
  5. Watch the device registration appear against its extension in ICTPBX

Troubleshooting

  • Phone boots but never registers. Double-check the MAC address on the device record. A single transposed digit means the phone’s config request finds no match.
  • Config request never reaches the server. Verify the provisioning URL is reachable from the phone’s network segment. Firewalls and voice VLANs often block it.
  • Phone registers with old settings. Reboot the phone after changing its device record. Config is fetched at boot, not continuously.
  • One model works, another does not. Check the provisioning parameters on the device record match your phone model, and confirm the handset runs current firmware.
Security note: keep phone firmware updated and block the phones’ own web interfaces from the public internet. Several desk phone vulnerabilities disclosed in 2026 target exposed phone admin pages, and provisioning is your central lever for pushing fixed firmware to the whole fleet.

Package Quotas

Your package defines a device slot limit. When you reach it, ICTPBX blocks new device registration. Ask your Super Admin to upgrade your subscription if you need more devices.

Related Features

  • Extensions – create the extension before assigning a device
  • My Account – end users can configure any SIP client using their credentials