ICTPBX installs with one command. The Service Provider Edition runs on Rocky Linux 9, and the Community Edition runs on Rocky Linux 8 or 9.
Prerequisites
| Requirement | Version |
|---|---|
| OS | Rocky Linux 9 (64-bit) for Service Provider Edition; Rocky Linux 8 or 9 for Community Edition |
| DNS | A DNS name pointing at the server (needed for HTTPS) |
| RAM | 4 GB minimum, 8 GB recommended |
| Disk | 40 GB minimum |
| CPU | 2 cores minimum |
Installation Steps
1. Point your DNS name at the server
Before you start, point a DNS name such as pbx.example.com at the server. The installer needs it to get a Let’s Encrypt certificate.
2. Run the installer
On a fresh server, run this as root. Replace <token> with the access token that came with your licence:
GIT_TOKEN=<token> DOMAIN=pbx.example.com TLS_EMAIL=you@example.com \
bash <(curl -fsSL -H "Authorization: token <token>" \
https://raw.githubusercontent.com/ictvision/ictpbx-frontend/main/install.sh)
The installer sets up MariaDB 10.11, PostgreSQL 16, PHP 8.3, Apache, FreeSWITCH 1.10.12, FusionPBX 6.6.0 (used only as a data store), the ICTCore API and the portal. It also gets the Let’s Encrypt certificate. Along the way it asks for the passwords it needs, including the admin password.
- If you leave out
DOMAINandTLS_EMAIL, the portal runs on plain HTTP and the browser softphone won’t work. - To install the AI Voice Agent too, add
WITH_AI=1 OPENAI_API_KEY=...to the command. - If you run the installer again on the same server, it asks whether to keep, upgrade or abort.
For the Community Edition, use install-ce.sh instead. It runs on Rocky Linux 8 or 9 and doesn’t need a token:
DOMAIN=pbx.example.com TLS_EMAIL=you@example.com \
bash <(curl -fsSL https://raw.githubusercontent.com/ictinnovations/ictpbx-community-edition-gui/main/install-ce.sh)
3. Open the firewall
- 80/tcp and 443/tcp for the portal, the API and the browser softphone
- 5080 UDP and TCP for SIP (desk phones, softphones and trunks)
- 16384-32768/udp for call audio (RTP)
There’s no SIP on 5060, so you don’t need to open it. Ports 5066 and 5067 are internal, so keep them closed. We also recommend fail2ban to block SIP brute-force attempts. The installer doesn’t set it up.
4. Check the services
systemctl status httpd php-fpm freeswitch mariadb postgresql memcached
All six services should show active (running).
Post-Install
- Open
https://<your domain>/and log in with the Super Admin account, using the admin password you entered during installation - Add your SIP carrier under Routing → Trunks, then add an outbound route under Routing → Routes
- Create your first tenant and tenant-admin user
Where the code lives
The Community Edition is open source and lives in two repositories. ictpbx-community-edition holds the PBX, built on ICTCore and FreeSWITCH. ictpbx-community-edition-gui holds the web portal and install-ce.sh. The Service Provider Edition installs from private repositories, so you’ll need an access token from ICT Innovations. Want an unattended Community Edition install? The Ansible role runs the same CE installer for you. Once it’s up, the getting started guide takes you through your first tenant and trunk. Bugs and questions go to the issue tracker on the repository.