1 Installation of the PortSIP PBX
The PortSIP PBX v16.x is an ALL NEW major release, which means it can't be upgraded from the PortSIP PBX v12.x installation automatically. Version 16.x must be installed on a new server which no v12.x installed.
The latest free edition of PortSIP PBX can always be found and downloaded at PortSIP Website. It’s available for both 64-bit Windows and Linux, but not for the 32-bit version.
The free edition of PortSIP PBX offers a maximum of 3 simultaneous calls and 10 extension registrations. If you require more simultaneous calls/extensions, please refer to the PortSIP PBX Pricing page to get more details.
You will get the installer after the download is completed.
- CentOS 7.9
- Ubuntu 18.04, 20.04, 22.04
- Debian 10.x, 11.x
It only supports 64-bit OS.
Tasks that MUST be completed before installing PortSIP PBX
- Ensure the server date-time is synced correctly.
- If the Linux on which PBX will be installed is located on a LAN, assign a
static private IP address
to the PBX server; if it's on a public network, assign astatic public IP address
and astatic private IP
to the PBX server. - Install all available updates and service packs before installing PortSIP PBX.
- Do not install PostgreSQL on your PortSIP PBX 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, and other similar software on the host machine.
- The PortSIP PBX must not be installed on a host that is a DNS or DHCP server.
- The below ports must be permitted by your firewall.
- UDP: 5060, 5066, 25000-35000, 45000–65000
- TCP: 5061, 5063, 5065, 5067, 8882, 8883, 8885, 8887, 8888, 10443. please also ensure the above ports have not been used by other applications.
- Must execute all Linux commands as the root user. please
su root
first.
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.Execute the below commands to download the installation scripts.
mkdir -p /opt/portsip
cd /opt/portsip
curl https://raw.githubusercontent.com/portsip/portsip-pbx-sh/master/v16.x/install_pbx_docker.sh \
-o install_pbx_docker.sh
curl https://raw.githubusercontent.com/portsip/portsip-pbx-sh/master/v16.x/pbx_ctl.sh \
-o pbx_ctl.sh
Execute the below command to install the
Docker-Compose
environment. If you get the prompt likes*** cloud.cfg (Y/I/N/O/D/Z) [default=N] ?
, enter the Y and then press the Enter button./bin/sh install_pbx_docker.sh
The below command is used to create and run the PBX on a server whose IP is
66.175.221.120
. If running the PBX in a LAN without the public IP, just replace the IP 66.175.221.120
with the PBX server's LAN private IP./bin/sh pbx_ctl.sh \
run -p /var/lib/portsip \
-a 66.175.221.120 \
-i portsip/pbx:16
Now you can use
https://66.175.221.120:8887
to access the PBX Web portal; the default system administrator name and password areadmin
.After successfully creating the PBX docker instance, you can use the below commands to manage it.
/bin/sh pbx_ctl.sh status
/bin/sh pbx_ctl.sh start
/bin/sh pbx_ctl.sh stop
/bin/sh pbx_ctl.sh restart
/bin/sh pbx_ctl.sh rm
- Windows 10, 11
- Windows Server 2016, 2019, 2022
It only supports 64-bit OS.
Tasks that MUST be completed before installing PortSIP PBX
- Ensure server date-time is synced correctly.
- If the Windows PC / server on which PBX will be installed is located in LAN, assign a
static LAN private IP address
for the server; if it's in a public network, assign astatic public IP address
and astatic private IP address
for the server. - Install all available Windows updates & service packs before installing PortSIP PBX. The reboot after installing Windows updates may reveal additional updates. Pay particular attention to installing all updates for Microsoft .Net before running the PortSIP PBX installation.
- Anti-virus Software should not scan the following directories to avoid complications and write access delays:
C:\Program Files\PortSIP
;C:\Programdata\PortSIP
- Do not install VPN and TeamViewer software on your PortSIP PBX Server
- Do not install
PostgreSQL
on your PortSIP PBX Server - Ensure the
Windows Firewall
service has been started. - Ensure that all power-saving options for your System and Network adapters are disabled (by setting the system to High-Performance mode).
- Disable Bluetooth adapters if it is a Windows client PC.
- PortSIP PBX must not be installed on a host which is a DNS or DHCP server, or that has MS SharePoint or Exchange services installed.
- The below ports must be permitted by your firewall.
- UDP: 5060, 5066, 25000-35000, 45000–65000
- TCP: 5061, 5063, 5065, 5067, 8882, 8883, 8885, 8887, 8888, 10443. Please also ensure the above ports have not been used by other applications.
- Ensure your Windows firewall is enabled.
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.
To install PortSIP PBX, you only need to double-click the installer, which will guide you through the installation process.
PortSIP PBX services will automatically start after successful installation (and thereafter every time your computer starts up).
The following two folders must not be the same when selecting the PBX folders during installation!

After having successfully installed PortSIP PBX, the PortSIP PBX ports have been opened automatically for Windows and Linux.
The below ports must be permitted on the firewall in order to make the PortSIP PBX work properly.
- UDP: 5060, 5066, 25000-35000, 45000–65000
- TCP: 5061, 5063, 5065, 5067, 8882, 8883, 8885, 8887, 8888, 10443. Please also ensure the above ports have not been used by other applications.
You also need to open the port that you are using for adding new transport:
- Assume you have added a TLS transport on port 5070, you must open TCP port 5070 in your Firewall.
- Assume you have added a TCP transport on port 5071, you must open TCP port 5071 in Firewall.
- Assume you have added a UDP transport on port 5078, you must open UDP port 5078 in your Firewall.
The below example is for creating the firewall rule that allows port 5070 on TCP.
sudo firewall-cmd --permanent --service=portsip-pbx \
--add-port=5070/tcp \
--set-description="PortSIP PBX"
sudo firewall-cmd --permanent --add-service=portsip-pbx
sudo firewall-cmd --reload
The below example is for creating the firewall rule that allows port 5078 on UDP.
sudo firewall-cmd --permanent --service=portsip-pbx \
--add-port=5078/udp \
--set-description="PortSIP PBX"
sudo firewall-cmd --permanent --add-service=portsip-pbx
sudo firewall-cmd --reload
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.
Please use the below steps to uninstall the PortSIP PBX for Linux.
Stop and delete the PBX Docker instances.
cd /opt/portsip
/bin/sh pbx_ctl.sh stop
/bin/sh pbx_ctl.sh rm
The below commands will delete the PBX data; please be careful.
cd /var/lib/portsip
rm -rf pbx
rm -rf postgresql
For the PBX Windows installation, just uninstall it from the Windows Control Panel.
Last modified 2mo ago