# 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
* It 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 a public network, please assign a static IP address for the 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- 35000 TCP: 8899– 8900、8887-8888、8881-8885 
* Make sure that the below ports have not been used by other programs: 
  * UDP: 45000– 65000, 25000- 35000 TCP: 8899– 8900、8887-8888、8881-8885 

{% hint style="info" %}
 **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.
{% endhint %}

###

### 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**

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

#### **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 using 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.*

```bash
# 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
```

In the future, once created the new transport in the PortSIP PBX, a 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.

```bash
# firewall-cmd --permanent --service=portsip-pbx \
               --add-port=5060/udp \
               --set-description="PortSIP PBX"
# firewall-cmd --permanent --add-service=portsip-pbx
# firewall-cmd --reload
```

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.

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

{% hint style="info" %}
 **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](https://www.portsip.com/portsip-pbx-user-guide/).
{% endhint %}

#### **Step 3: C**onfiguring the PortSIP PBX

Sign in to the PortSIP PBX Web Portal to configure the PBX by opening the below URL. For more details please follow the [PBX User Guide](https://www.portsip.com/portsip-pbx-user-guide/).

> <http://66.175.222.20:8888>&#x20;
>
> <https://66.175.222.20:8887>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://support.portsip.com/pbx_v12/tutorials/setup-portsip-pbx-linux.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.