Installation PortSIP SBC v10.x
If your PortSIP PBX has already been upgraded to version 22.x, you will also need to upgrade your PortSIP SBC from version 10.x to version 11.x in order to use the latest WebRTC app.
Before proceeding, please review the following sections carefully:
Supported OS
Debian 11.x, 12.x
Ubuntu 22.04, 24.04
Windows 10 1903/19H1 or higher, Windows 11
Windows Server 2022 or higher
Preparing the Server for Installation
Tasks that MUST be completed before installing PortSIP SBC.
Ensure the server date-time is synced correctly.
For the Linux, use the
sudoto perform the installation is recommended. For Windows, it requires the Administrator user.If the server on which SBC will be installed is located on a LAN, assign a
static private IP addressto the PBX server; if it's on a public network, assign astatic public IP addressand astatic private IPto the PBX server.Install all available updates and service packs before installing PortSIP SBC.
Do not install PostgreSQL on your PortSIP SBC Server.
Ensure that all power-saving options for your system and network adapters are disabled (by setting the system to High-Performance mode).
Do not install TeamViewer, VPN, or other similar software on the host machine.
The PortSIP SBC must not be installed on a host that is a DNS or DHCP server.
The below ports must be permitted by your firewall(these ports are required by the PortSIP SBC).
UDP: 5066, 25000-34999
TCP: 5065, 5067, 10443. please also ensure the above ports have not been used by other applications.
If installed on Windows, ensure the
Windows Firewallservice has been started.
If the PBX runs on a cloud platform such as AWS and the cloud platform has its own firewall, you must also open the ports on the cloud platform's firewall.
All commands must be executed in the /opt/portsip directory.
Prerequisites
Assume that you have successfully installed the PortSIP PBX following the instructions in the Installation of the PortSIP PBX guide.
Install the PortSIP SBC and PBX on the Same Server
The PortSIP SBC can be deployed with the PortSIP PBX on the same server. In this configuration, the PBX handles SIP calling directly, while the SBC provides WebRTC services and enables interworking for Microsoft Teams Direct Routing.
For this example, assume the following server configuration:
Private IP: 192.168.1.72
Public IP: 66.175.221.120
The domain uc.portsip.cc is resolved to the public IP address 66.175.221.120.
A trusted SSL certificate(not self-signed) is installed for the domain uc.portsip.cc. Please follow the article Certificates for TLS/HTTPS/WebRTC to prepare the certificates.
Install PortSIP SBC for Linux
To install the SBC, please perform the below commands:
sudo cd /opt/portsipsudo curl https://raw.githubusercontent.com/portsip/portsip-pbx-sh/master/v16.x/new/sbc_ctl.sh \
-o sbc_ctl.shsudo /bin/sh sbc_ctl.sh run -p /var/lib/portsip -i portsip/sbc:10Install PortSIP SBC for Windows
You can download the PortSIP SBC installer at PortSIP Website, just double click the installer and follow the instructions to install it.
Configuring PortSIP SBC
Now follow the guide Configure PortSIP SBC on the Same Server as PortSIP PBX to complete the SBC configuration.
Install the PortSIP SBC on a Separate Server
Typically, the PortSIP SBC is deployed on a separate server from the PortSIP PBX. In this configuration, the SBC acts as a front-end component, while the PBX remains transparent to the end users.
Assuming the following server configuration for installation:
PBX Server (Private IP): 192.168.1.72
SBC Server (Private IP): 192.168.1.73
SBC Server (Public IP): 66.175.221.120
The domain sbc.portsip.cc is resolved to the SBC server's public IP, 66.175.221.120.
The domain uc.portsip.cc is resolved to the PBX server's private IP, 192.168.1.72. (Note: This step is not necessary for the SBC deployment.)
A trusted Wildcard SSL certificate(not self-signed) is installed for the domain portsip.cc. Please follow the article Certificates for TLS/HTTPS/WebRTC to prepare the certificates.
Install PortSIP SBC for Linux
Please follow the below steps to install the PortSIP SBC on that separate server.
mkdir -p /opt/portsip
cd /opt/portsipcurl https://raw.githubusercontent.com/portsip/portsip-pbx-sh/master/v16.x/new/install_docker.sh \
-o install_docker.shcurl https://raw.githubusercontent.com/portsip/portsip-pbx-sh/master/v16.x/new/sbc_ctl.sh \
-o sbc_ctl.shExecute the below command to install the Docker-Compose environment. If get the prompt like*** cloud.cfg (Y/I/N/O/D/Z) [default=N] ?, enter the Y and then press the Enter button.
sudo /bin/sh install_docker.shNow, execute the following command to create and run the PortSIP SBC Docker instance.
sudo /bin/sh sbc_ctl.sh run -p /var/lib/portsip -i portsip/sbc:10Install PortSIP SBC for Windows
You can download the PortSIP SBC installer from the PortSIP Website. Simply double-click the installer and follow the on-screen instructions to complete the installation.
Configuring PortSIP SBC
Now follow the guide Configure PortSIP SBC on a Separate Server to complete the SBC configuration.
Managing PortSIP SBC Docker Instance
After successfully installing the SBC, you can use the following commands to manage the PortSIP SBC docker instance.
cd /opt/portsipShow the SBC Docker Instance Status
sudo /bin/sh sbc_ctl.sh statusStart the SBC Docker Instance
sudo /bin/sh sbc_ctl.sh startStop the SBC Docker Instance
sudo /bin/sh sbc_ctl.sh stopRestart the SBC Docker Instance
sudo /bin/sh sbc_ctl.sh restartDelete the SBC Docker Instance
This command will not delete the data of the SBC.
sudo /bin/sh sbc_ctl.sh rmLast updated