Configure UniFi phones from Ubiquiti via UniFi VoIP Controller

Created April 2016 - Last Edited April 2016

SECURITY ALERT (September 2011): Do NOT put phones on static IP addresses directly on the Internet. If there is no other option, you must at least disable port 80 (WWW) inbound to any phone device. If this precaution is not taken, OnSIP is not liable for any charges you may incur due to access to the phones.

Adopt the phone to the UniFi VoIP Controller.  On the phone itself, set the HTTPS Username and password under Maintenance.  Then, in the UniFi controller, you should be able to Adopt the phone to the UniFi VoIP controller via the interface.  Once you see Status: Connected under the devices section, you can then proceed with the remainder of the directions. 

The UniFi VoIP Controller can be downloaded here.

OnSIP Functionality Notes:

The UniFi phones work with OnSIP.  However, they do not support Music On Hold in the way that OnSIP provides it.  We have also seen issues with attended transfers in some situations.  Blind transfer works in cases.

Step 1: Gather information for each user.

Each user has a set of credentials which will be needed to configure each phone. For each phone that you are configuring, obtain the following:

  • SIP Address (Address of Record)
  • SIP Password
  • Auth Username
  • Username
  • Domain
  • Outbound Proxy

You can find this information in the user detail pages under the Users tab in the Phone Configuration section.

Step 2: Enter information for each user.

On the VoIP Controller choose "Settings" from the lower left of the screen.  Choose VOIP from the left menu.

SIP Server:

Click on Advanced Options.

Outbound Proxy:

SIP Voicemail: *98

Click on "Apply"

Then choose "Extensions" from the left menu.  Click "Create New Extension".  At this point you are presented with a page of fields.  Be careful with the VoIP password as it's long and case sensitive.

Note that OnSIP uses username/password authentication, not IP authentication.

  • Extension = whatever you want e.g. 101
  • Account ID = Choose 1.  This is the "line" number.
  • Name = Whatever you want for the name
  • SIP Username = just your username e.g. hiro
  • SIP Password = your SIP Password e.g. VqWyYuVcmM2yfYhb
  • SIP Server = your domain e.g.
  • Phone = Choose the phone from the drop down

Click on Advanced Options

  • Authentication ID Auth Username e.g. example_hiro
  • Outbound Proxy =  **important
  • SIP Voicemail = *98
  • SIP Regisstration Expiry = 60
  • CSCP for RTP = 46
  • TCP over SIP = unchecked

Choose "OK".

Step 3: Remove unnecessary codecs.

Choose Settings, SIP Service and Audio Codecs.  Uncheck all Codecs except G.722, G.711 PCMA and G.711 PCMU. 

Step 4. Confirm that your phone is registered.

In the OnSIP Admin portal, click on the "Users" tab. You will see a green "online" notation next to each user with a registered phone.

You should now be able to place and receive calls.

If there are any issues, check your settings and re-enter your SIP Password. 


See our top business VoIP phone recommendations

Download the 2017 Business Phone Guide

Was this article helpful?
0 out of 0 found this helpful