Setup PortSIP PBX for Linux
PortSIP PBX Linux edition is migrated to docker environment, which does not support RPM and Deb installer.

Supported Linux OS

  • CentOS: 7.9
  • Ubuntu: 18.04, 20.04
  • Debian: 10.x
  • Only supports 64bit OS

Preparing the Linux Host Machine for Installation

Tasks that MUST be completed before installing PortSIP PBX.
  • If the Linux on which PBX will be installed is located in LAN, assign a static LAN IP address; if it's in public network, please assign static IP address for public network
  • Install all available updates & 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)
  • Do not install TeamViewer, VPN and other similar software on the host machine
  • PortSIP PBX must not be installed on a host which is a DNS or DHCP server
  • Below ports must be permitted by your firewall.
    • UDP: 45000– 65000, 25000- 34999 TCP: 8899– 8900、8887-8888、8881-8885
  • Make sure that below ports have not been used by other programs:
    • UDP: 45000– 65000, 25000- 34999 TCP: 8899– 8900、8887-8888、8881-8885
Imortant: If the PBX running on a cloud platform such as AWS, and the cloud platform has the firewall itself, you MUST open the ports on the cloud platform firewall too.

Installing a fresh PortSIP PBX for Linux

  • Ensure server date-time is synced correctly
  • Must perform all Linux commands by the root user, please su root first

Step 1. Perform below command

1
# curl https://raw.githubusercontent.com/portsip/portsip-pbx-sh/master/v12.6.x/install_pbx_docker.sh|bash
Copied!

Step 2: Create and run the PortSIP PBX Docker container instance

Performing the below command will launch the PortSIP PBX docker instance on a Linux server for which the IP is 66.175.222.20.
  • The POSTGRES_PASSWORD is used to specify the PortSIP DB password. In this case, we will use 123456, you can change it by yourself. Suggest use alphanumeric only, special character maybe causes problems.
  • The IP_ADDRESS is the IP address of your PBX server (Linux Server). In this case, it is 66.175.222.20, you will need to change it by yourself.
1
# docker container run -d --name portsip-pbx --restart=always --cap-add=SYS_PTRACE --network=host -v /var/lib/portsip:/var/lib/portsip -v /etc/localtime:/etc/localtime:ro -e POSTGRES_PASSWORD="123456" -e POSTGRES_LISTEN_ADDRESSES="*" -e IP_ADDRESS="66.175.222.20" portsip/pbx:12
Copied!
In the future, once created the new transport in the PortSIP PBX, the new firewall rule must be added to enable the transport port.
For example: if created the UDP transport on port 5060, add the below new firewall rule to enable the UDP port 5060.
1
# firewall-cmd --permanent --service=portsip-pbx --add-port=5060/udp --set-description="PortSIP PBX"
2
# firewall-cmd --permanent --add-service=portsip-pbx
3
# firewall-cmd --reload
Copied!
If there created TCP transport on port 5063 and WSS transport on port 5065, add the below new rules to enable TCP ports 5063 and 5065.
1
# firewall-cmd --permanent --service=portsip-pbx --add-port=5063/tcp --add-port=5065/tcp --set-description="PortSIP PBX"
2
# firewall-cmd --permanent --add-service=portsip-pbx
3
# firewall-cmd --reload
Copied!
Important: If the PBX running on a cloud platform such as AWS, and the cloud platform has the firewall itself, MUST open the ports on the cloud platform firewall too. For more details please read the PBX User Guide.

Step 3: Configuring the PortSIP PBX

Sign in the PortSIP PBX Web Portal to configure the PBX by open the below URL. For more details please follow the PBX User Guide.
Last modified 2mo ago