VOS3000 fix

VOS3000 SIP registration failed

A phone or softphone will not register to your switch. Work through these checks in order.

Updated · By the VOS3000 Web team

Quick answer: When a SIP phone or softphone will not register to VOS3000, check four things in order: the phone number and password match the phone entry, the phone uses your switch's SIP port, its IP address is allowed on the SIP firewall, and the phone is not locked. The status light in the phone list turns on when it registers.

Where phones are
Phone Management
Login
Phone Number and Password
Default SIP port
5060, changed on the SIP Firewall page
CDR clues
UnRegistered (-31), 401, 407

How phones are set up in VOS3000

In VOS3000 Web, phones are under Phone Management in the top-bar menu. Each phone has an Account, a Phone Number, a Password, a Capacity (concurrent calls, 1 by default), a Lock Type and a Call Permission. The phone list shows a status light that turns on when the phone is registered.

On the phone or softphone, enter your switch's IP address or domain as the server, your SIP port, the Phone Number as the user name and the Password from VOS3000.

1. Check the phone number and password

Most failures are simple typos. The user name must be the Phone Number exactly as it is in VOS3000, and the password must match. A 401 Unauthorized or 407 Proxy Authentication Required reply points here.

2. Use the right SIP port

The default SIP port is 5060. You can change it, or add up to three ports, under Firewall → SIP Firewall → Edit SIP Port. If you changed it, every phone must use the new port. Some internet providers block port 5060, which is a common reason to use another one.

3. Allow the phone on the SIP firewall

If the SIP firewall is on, it only lets in addresses you allow. Check that the phone's public IP address is allowed. Phones whose address changes need the new address allowed.

4. Check the Lock Type

A phone's Lock Type can be No Lock, Bar Outgoing, Bar Incoming or Bar All Calls. Make sure the phone is not barred for the calls you expect.

5. Check the network

  • Turn off SIP ALG on the router in front of the phone.
  • Make sure the phone can reach the server, for example by testing from another network or mobile data.
  • If the phone registers but audio fails, see one-way audio.

Clues in the CDR

Calls to a phone that is not registered end with UnRegistered (-31). Calls refused for authentication can show CallAuthenticationFailure (-6). See reading VOS3000 CDR for more reasons.

In the VOS3000 desktop client

Phones are under Operation management → Phone operation → Phone management, and Online phone in the same place lists the phones that are registered right now. Operation management → Business analysis → Registration analysis helps when many phones fail to register.

Questions about this topic

What username does a phone use to register?

The Phone Number from the phone entry in VOS3000, with the Password from the same entry.

I changed the SIP port. Why did all phones go offline?

Phones and gateways must use the new port. Update the SIP port in every phone and tell your customers and carriers. Changing the SIP port also restarts the softswitch briefly.

The phone registers but cannot make calls. Why?

Check the phone's Lock Type and Call Permission, and the balance of its account. A call that fails with InsufficientBalance (-2) means the account has run out of credit.

Can a gateway register instead of using a fixed IP?

Yes. Choose the Registration gateway type and enter a registration identification instead of an IP address.

Try every step in the live demo

Each screen in this guide is in the VOS3000 Web demo, with made-up data. Sign in with demo / demo.