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.6+,less than 8.0, recommend 7.9.
  • Ubuntu: 16.04 or 18.04.
  • Debian: 9.5+, less than 10.0
  • Only supports 64bit OS

Step 1. Perform below command

$ sudo 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 add new firewall rule to enable the UDP port 5060:


$ sudo firewall-cmd --permanent --service=portsip-pbx --add-port=5060/udp

Ubuntu / Debian:

$ sudo ufw allow 5060/udp

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


$ sudo firewall-cmd --permanent --service=portsip-pbx --add-port=5063/tcp

$ sudo firewall-cmd --permanent --service=portsip-pbx --add-port=5065/tcp

Ubuntu / Debian:

$ sudo ufw allow 5063/tcp

$ sudo ufw allow 5065/tcp

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.