How to fix a VICIdial phone that won't register

When a phone will not register to VICIdial, the agent cannot take or place calls, so it is worth fixing in a clear order rather than guessing. Registration is the handshake where your phone tells the Asterisk server who it is, and almost every failure comes down to a wrong credential, a wrong address, a mismatched protocol, or a blocked port. Work through them top to bottom.

Check the password you are using

This is the most common trap. VICIdial has two passwords on a Phone record and they do different jobs. The Login Password is only for logging into the agent web screen. The device registers with the Registration Password instead, which is the secret in the auto-generated SIP or IAX config. If your phone keeps getting rejected, you are almost certainly typing the Login Password where the Registration Password belongs. The two are easy to confuse, so the login vs registration password guide is worth a read if this is your problem.

Check the Server IP

The phone has to point at the right box. On the Phone record the Server IP selects which server the phone is active on, and the value the device registers to has to match it. A typo in the IP, or a phone aimed at an old server, means the SIP (Session Initiation Protocol) REGISTER never reaches Asterisk and you see no attempt at all on the server. Confirm the address in the phone's settings matches the Server IP on the record.

Check the protocol

The Client Protocol field on the Phone record says how the device connects: SIP, PJSIP, IAX2, or Zap. If the record says SIP but your softphone is set to IAX2, the two will never agree. Match the protocol in the device to the protocol on the record. Remember too that SIP and IAX phones have their Asterisk settings built automatically within about a minute of saving the form, so if you just created the record, give it that moment before deciding it is broken.

flowchart TD
  A[Phone will not register] --> B{Using Registration Password not Login}
  B -->|No| C[Switch to Registration Password]
  B -->|Yes| D{Server IP matches record}
  D -->|No| E[Fix the Server IP]
  D -->|Yes| F{Protocol matches record}
  F -->|No| G[Match SIP or IAX2]
  F -->|Yes| H{SIP and RTP ports open}
  H -->|No| I[Open the firewall ports]
  H -->|Yes| J[Wait one minute for auto-create]

Check the network path

If the credentials and protocol all line up but the phone still cannot reach the server, the problem is usually the network in between. Registration runs over a SIP port and the audio runs over RTP, and a firewall that blocks either one stops the phone cold. Agents behind home routers also hit NAT traversal issues, where the router rewrites addresses and the phone and server disagree about where to send packets. Open the SIP and RTP ports and make sure nothing on the path is dropping them.

Confirm it is fixed

Once you have corrected the password, IP, protocol, and ports, the phone should register within a few seconds. To prove it, the registration test with sip show peers shows the device online from the server side. The VICIdial phones guide ties the whole topic together.

Most registration headaches vanish on a clean, properly configured server. A managed VICIdial box comes with the firewall and Asterisk already set up the right way, so phones just connect. See VICIfast pricing to get one running in under 40 seconds.