Install PBXware
Welcome to the PBXware installation guide, an all-in-one business telephony solution based on the VoIP call management system.
This document is designed to guide you step by step throughout the process of installing PBXware on your server, ensuring an optimal configuration for your communication needs.
Before starting, please make sure you have all the necessary prerequisites, including access to a compatible server, a stable internet connection, as well as the information specific to your network configuration.
INFORMATION:
Installing PBXware requires basic knowledge of server management and/or command-line OS installation. It is helpful to have some experience with networking, Linux operating systems and virtualization platforms (such as VMware or Hyper-V).
This document describes the steps to manually install PBXware.
Installing PBXware requires basic knowledge of server management. It is helpful to have some experience with networking, Linux operating systems and virtualization platforms (such as VMware or Hyper-V).
Prerequisites
- Hardware or virtual platform: A physical machine (for example, a bare-metal server) or a virtual machine
- PBXware ISO image : Download the latest version of the PBXware ISO from the download center
- Startup media : A bootable USB drive, a burned ISO, or the ability to boot from the network (for example, via an ILO card on a physical server).
- Hardware compatibility : Make sure your hardware is compatible with the PBXware requirements described in the section below.
These prerequisites ensure a smooth and efficient installation of PBXware on your system.
Requirements
Resources required for PBXware installations:
| Minimum | Suggested | |
|---|---|---|
| CPU | Quad Core x86 CPU1 | Quad Core or newer Xeon CPU |
| RAM | 2 GB2 | 4 GB |
| Storage | 10 GB HDD | 20 GB SSD |
| Network | 1 Gb network card | 1 Gb network card with OOBM³ on a dedicated network card |
1 – Intel Gen 8 and newer desktop processor (Gen 8 released in 2017)
2 – 2 GB is the minimum for the Business edition, however the Call Center (without Clickhouse) and Multi-Tenant editions require a minimum of 4 GB of RAM on standalone installations.
3 – OOBM (Out Of Band Management) – IPMI, iDRAC, iLO or similar platform.
If the ClickHouse database is used, the processor must support the SSE4.2 instructions
Compatible processors include:
- Intel® : Celeron®, Pentium® II, Pentium III, Pentium 4, Xeon™, Core®, Core® 2, Core® iX, Atom
- AMD™ : Athlon™, Athlon MP, Athlon XP, Athlon X series, Duron™, Opteron™
- Via : C3, C7
Please note that if the server operates from a private LAN IP, the firewall must be configured to open/forward certain ports.
The above hardware requirements should be sufficient for low to moderate usage systems.
However, due to a large number of variables such as the number of active extensions, the number of simultaneous calls, the number of ring groups, call recording, transcoding, etc., the only way to know whether specific hardware would meet your needs is to carry out thorough testing or deploy hardware that exceeds our suggested hardware recommendations.
Furthermore, please make sure to take into account the future expansion of the system, since each future hardware upgrade will cause system downtime and a possible service interruption for your users. Therefore, a certain hardware margin is strongly recommended for each installation.
Supported browsers
Non-exhaustive list of all browsers that can support the display of PBXware:
- Chrome
- Firefox
- Safari
- Opera
- Microsoft Edge
- Brave
- …
Support assistance
In order to provide full support when necessary, we need access to the system via the SSH, HTTP/HTTPS protocols. The following are required:
• Access to the system server as the 'root' user
• Operational network configuration, forwarding or opening of ports to ports 2020, 80, 81 and 443.
Installation guide
PBXware can be installed by one of the following methods:
Any installation method will result in the installation and startup of the machine and all necessary software, allowing the administrator to connect to that machine from a browser.
NOTE:
If your instance is located behind a firewall, certain ports must be opened; please find the list of ports below.
Ports to open
Here is the list of the various ports to open on your firewall if your PBXware instance is located behind it.
Opening these ports will ensure PBXware works properly.
| Service | Protocol | Ports |
|---|---|---|
| Update ports | TCP | 873 |
| Web interface | TCP | 80, 81, 443 |
| SSH access | TCP | 2020 |
| SIP/RTP traffic | TCP | 10001, 5060-5069 |
| UDP | 4000-4999, 5060-5069, 10000-20000 | |
| IAX traffic | TCP | 5037, 5038 |
| UDP | 4569 | |
| PWProxy | TCP | 10005, 10007, 10009 |
| Centralized directory | TCP | 11389, 11636 |
| BSSUP (Support access) | TCP | 2244 |
