2 Configuring the PortSIP PBX

After the PortSIP PBX has been installed successfully, use your browser to access the web portal at If the browser displays the SSL certificate warning, simply ignore it and proceed, you will see the login page likes the below screenshot.

Please click the "Sign in as the administrator or dealer" to navigate to the administrator login page likes the below screenshot, enter admin for both the username and password to sign in the web portal.

Please change the default password of admin after you logged in.

After successfully logged in to the PBX Web Portal, the PBX dashboard page should look like the one in the screenshot below.

Setup Wizard

If you have not completed the setup wizard yet, it will appear automatically after you sign in to the web portal. To make the PBX work, some settings must be configured.

Step 1: Network Environment

If the PBX server has a static public IP address, enter it for "Public IPv4". If the PBX server does not have a static public IP, do not enter "Public IPv4".

The private IPv4 address must be entered, if your server is without the private IP, please enter the public IP instead.

The public IP and private must be reachable by your SIP client. The IP address entered here is the SIP server IP address for PBX. It is required when a SIP client or IP phone registers to PortSIP PBX should be configured as the "Outbound Proxy Server".

If the PBX is located on the cloud, both the "Private IPv4" and "Public IPv4" should be entered here. If located in LAN, just enter the "Private IPv4" only.

The loopback interface ( is unacceptable for the private IP. Only the static IP for the LAN where the PBX is located is allowed (do not use DHCP dynamic IP).

Step 2: Certificate File

In order to support TLS transport for SIP, and provide HTTPS access for the Web Portal and REST API, we must have a trusted SSL certificate and upload it to PBX in this step.

You will need to have a web domain, for example, purchase a domain from a domain provider such as Godaddy, and resolve the domain to your PBX IP.

You will also need to purchase a trusted SSL certificate for this domain to avoid the browser warning. The certificate provider Digicert, GeoTrust, Godaddy, or other certificate providers are recommended.

If you don't have the domain or certificate, you can simply enter the PBX IP as the Web Domain, and accept the default certificate here. By default, the PortSIP PBX uses a self-signed certificate, which will cause the browser to block the connection and pop-up the warning information.

Please follow up this guide for purchase the SSL certificate: Preparing TLS Certificates for TLS/HTTPS/WebRTC.

You have two certificate files.

  • portsip.key

  • portsip.pem

Enter uc.portsip.cc in the Web Domain field; open the portsip.pem file in Windows Notepad and copy all contents to the "Certificate File" field; and copy the contents of the portsip.key file to the "Private Key File" field.

Step 3: Transport Protocol

You can set the transport layer protocol for SIP signaling by clicking the Add button. By default, the transport ports are:

  • UDP: 5060

  • TCP: 5063

  • TLS: 5061

You can feel free to change the default port to a new port that you prefer, but the port should not be used by other applications.

Once a new transport has been added, you have to change the firewall rule to allow the transport port. The IP Phone client app will connect to the PBX via transport and port.

Step 4: System Notifications

To enable email notifications with PortSIP PBX for sending some system alert messages, the SMTP details must be configured.


If you are using the Google SMTP server, please make sure that you have “less secure” enabled for your Gmail account. Please refer to the below links for more details:

Less secure apps & your Google Account

You also need to select SSL or TLS security protocol if you’re using Google SMTP Server.

  • SMTP Server: smtp.gmail.com

  • Port: 587

  • Username: The username of the SMTP server

  • Password: Your password

  • Sender Email: The sender's email address

  • Use TLS: ON

Microsoft 365

If you are using the Microsoft 365 SMTP server, you also need to select SSL or TLS security protocol if you’re using Microsoft 365 SMTP Server.

  • SMTP Server: smtp.office365.com

  • Port: 587

  • Username: The username of the SMTP server

  • Password: Your password

  • Sender Email: The sender's email address

  • Use TLS: ON

Once the PBX occurs some critical event, the alert email will be sent to "Recipients".

Reboot to Make the Certificate Take Effect

If you uploaded the trusted certificate rather than the self-signed certificate in Step 2: Certificate File, please use the below commands to restart the PBX to make the certificate take effect.

cd /opt/portsip
/bin/sh pbx_ctl.sh restart

For Windows, just simply restart the server.

Last updated