Setup PortSIP PBX for Linux

You are here:
← All Topics

From v12, PortSIP PBX has been migrated to the docker environment for Linux. Please follow the below steps to set up the PortSIP PBX.

Note: the OS required:

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

Important: from v12.6.1, the PortSIP PBX requires running with the above Linux OS versions. If there installed the PortSIP PBX which less than v12.6.1, and wish to upgrade to v12.6.1 or a later version, must upgrade the Linux OS to the above version before upgrade the PortSIP PBX.


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

Step 1. Perform below command

# curl|bash

Step 2: Now 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

  • 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, you will need to change it by yourself.

# 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="" portsip/pbx:12

Note: once you have created the transport in the PortSIP PBX, you will need to add a new firewall rule to enable your transport port. For example:if you create the UDP transport on port 5060, you will need to add a new firewall rule to enable the UDP port 5060:

sudo firewall-cmd --permanent --service=portsip-pbx --add-port=5060/udp --set-description="PortSIP PBX"
sudo firewall-cmd --permanent --add-service=portsip-pbx
sudo firewall-cmd --reload

if you create the TCP transport on port 5063 and create WSS transport on port 5065, you will need to add a new firewall rule to enable TCP port 5063 and 5065.

sudo firewall-cmd --permanent --service=portsip-pbx --add-port=5063/tcp --add-port=5065/tcp --set-description="PortSIP PBX"
sudo firewall-cmd --permanent --add-service=portsip-pbx
sudo firewall-cmd --reload

IMPORTANT: If you running the PBX 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. For more details please read the PBX User Guide.

Step 3: Open the PortSIP PBX Web Management Console to configure the PortSIP PBX, please follow the PBX User Guide.