Tutorials: Phone Setup

Phone Setup
Learn how to add an IP phone to FreePBX! In this demo we used a Fanvil; but brands like SNOM, Yealink, Polycom, and Grandstream will be a similar process!

Required Access: FreePBX


In this guide we will be setting up a Fanvil IP phone on the FreePBX system; other phones like Polycom, SNOM, Yealink, and Grandstream will be similar.


Last Updated: 5/8/2025

Make sure the phone restarts to its default settings, because we do not want to reach out to another PBX system.

freepbx login

Log in to your FreePBX server with your credentials.

extentions page in freepbx



Go to the "Extensions" page, which can be found under the "Applications" tab.

freepbx extension



If you need to add a new extension, view the Add Extension tutorial.

general settings in freepbx



Under the "General" settings, copy the Secret.

We do not recommend changing this password to something easier, as this allows hackers to easily access your extension to make fraudulent calls. If your extension is compromised, please update this password right away and make it very complex.

The following steps cover how to set up the IP Phone.

gui for the ip phone



You can access the phone GUI by typing in the phone's IPv4 address in your browser. If you do not know the phone's IP address, it can usually be found in the phone's network settings or with a network scan.

information icon
Important Note: We recommend changing your default password on the phone to help secure your phone and phone system.

default login for phone

Enter the default login and password for the phone; you can search for the default password for your phone online.

ip phone setup settings



  1. Once you are logged into Fanvil go under "Line" then "SIP"

  2. Make sure the user is active

  3. Use your extension number as the "Username" and "Authentication User"

  4. Set the "Display Name" to the extension's name

  5. Set the "Realm" and "Server Address" to the public IP address of the FreePBX

  6. Set the "Authentication Password" to the "Secret" from the extension on FreePBX

  7. Apply the settings

After you are done configuring your IP phone, make some test calls.