📦 Ring2All PBX - Installation Guide

Complete installation guide for deploying Ring2All PBX platform

---

📋 Overview

Ring2All PBX can be deployed in two main configurations:

Configuration	Description	Best For
Single Server	All components on one machine	Small businesses, demos, development
Distributed (Multi-Server)	Components across multiple servers	Enterprise, high availability, scalability

---

🖥️ Single Server Deployment

The simplest deployment where all components run on a single server.

Plaintext

┌─────────────────────────────────────────────────────────────────────────────────┐
│                          SINGLE SERVER ARCHITECTURE                              │
│                           (All-in-One Deployment)                                │
├─────────────────────────────────────────────────────────────────────────────────┤
│                                                                                  │
│   ┌───────────────────────────────────────────────────────────────────────┐     │
│   │                         NGINX (Reverse Proxy)                          │     │
│   │                          Port 80/443 (HTTP/S)                          │     │
│   └───────────────────────────────────────────────────────────────────────┘     │
│        │              │              │              │              │             │
│        ▼              ▼              ▼              ▼              ▼             │
│   ┌─────────┐   ┌─────────┐   ┌─────────┐   ┌─────────┐   ┌─────────┐          │
│   │  Admin  │   │  Portal │   │Switchbd │   │   API   │   │   WS    │          │
│   │   Web   │   │   Web   │   │   Web   │   │ :3000   │   │ :3001   │          │
│   └─────────┘   └─────────┘   └─────────┘   └─────────┘   └─────────┘          │
│                                                   │                              │
│                                                   ▼                              │
│   ┌───────────────────────────────────────────────────────────────────────┐     │
│   │                        PostgreSQL 17                                   │     │
│   │   ss_admin | ss_telephony | ss_cdr | ss_cc | ss_logs | freeswitch    │     │
│   └───────────────────────────────────────────────────────────────────────┘     │
│                                    │                                             │
│                                    ▼                                             │
│   ┌───────────────────────────────────────────────────────────────────────┐     │
│   │                         FreeSWITCH                                     │     │
│   │                SIP: 5060 | RTP: 16384-32768                           │     │
│   └───────────────────────────────────────────────────────────────────────┘     │
│                                                                                  │
│                         Single Server: your-server-ip                           │
└─────────────────────────────────────────────────────────────────────────────────┘

Capacity & Requirements

Component	Minimum	Recommended	High Performance
CPU	4 vCPU	8 vCPU	16+ vCPU
RAM	8 GB	16 GB	32+ GB
Storage	100 GB SSD	250 GB SSD	500+ GB NVMe
OS	Debian 13	Debian 13	Debian 13
Concurrent Calls	~50	~150	~500+
Extensions	~500	~2,000	~10,000

> 💡 Note: With high-performance hardware (16 vCPU, 32GB RAM, NVMe storage), a single server can handle up to 10,000 extensions and 1,500 concurrent calls.

📖 Complete Single Server Installation Guide

---

🏗️ Distributed Deployment (Multi-Server)

Enterprise-grade deployment with components distributed across multiple servers for maximum scalability, redundancy, and performance.

Plaintext

┌─────────────────────────────────────────────────────────────────────────────────────────────┐
│                              DISTRIBUTED ARCHITECTURE                                        │
│                          (Enterprise Multi-Server Deployment)                                │
├─────────────────────────────────────────────────────────────────────────────────────────────┤
│                                                                                              │
│                           ┌─────────────────────────────────┐                               │
│                           │   LOAD BALANCER (HAProxy/Nginx)  │                               │
│                           │      Public IP: lb.example.com   │                               │
│                           └────────────────┬────────────────┘                               │
│                                            │                                                 │
│         ┌──────────────────────────────────┼───────────────────────────────────┐            │
│         │                                  │                                    │            │
│         ▼                ▼                 ▼                  ▼                 ▼            │
│   ┌──────────┐    ┌──────────┐    ┌────────────┐    ┌────────────┐    ┌────────────┐       │
│   │  ADMIN   │    │  PORTAL  │    │ SWITCHBOARD │    │    API     │    │ MONITORING │       │
│   │  Server  │    │  Server  │    │   Server    │    │  Server(s) │    │    API     │       │
│   └──────────┘    └──────────┘    └────────────┘    └────────────┘    └────────────┘       │
│         │                │               │                  │               │                │
│         └────────────────┴───────────────┴──────────────────┴───────────────┘                │
│                                          │                                                   │
│                    ┌─────────────────────┴─────────────────────┐                            │
│                    │                                           │                            │
│                    ▼                                           ▼                            │
│   ┌────────────────────────────────────┐    ┌───────────────────────────────────────────┐  │
│   │     POSTGRESQL HA CLUSTER          │    │          FILE SERVER CLUSTER              │  │
│   │  ┌──────────┐ ┌──────────┐        │    │  ┌──────────┐ ┌──────────┐ ┌──────────┐  │  │
│   │  │ Primary  │ │ Replica  │ ...    │    │  │ FS-01    │ │ FS-02    │ │ FS-03    │  │  │
│   │  │ Patroni  │ │ Patroni  │        │    │  │ GlusterFS│ │ GlusterFS│ │ GlusterFS│  │  │
│   │  └──────────┘ └──────────┘        │    │  └──────────┘ └──────────┘ └──────────┘  │  │
│   │       PostgreSQL 17 + Etcd         │    │        GlusterFS Replica 3 Volume        │  │
│   └────────────────────────────────────┘    └───────────────────────────────────────────┘  │
│                    │                                                                        │
│                    │                                                                        │
│   ┌────────────────────────────────────────────────────────────────────────────────────┐   │
│   │                         TELEPHONY CLUSTER (N+1 Scalable)                            │   │
│   │  ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐              │   │
│   │  │   FS-TELE-01 │ │   FS-TELE-02 │ │   FS-TELE-03 │ │   FS-TELE-N  │              │   │
│   │  │  FreeSWITCH  │ │  FreeSWITCH  │ │  FreeSWITCH  │ │  FreeSWITCH  │    ...       │   │
│   │  │  10,000 ext  │ │  10,000 ext  │ │  10,000 ext  │ │  10,000 ext  │              │   │
│   │  │  1,500 calls │ │  1,500 calls │ │  1,500 calls │ │  1,500 calls │              │   │
│   │  └──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘              │   │
│   │                           Add servers as needed (Horizontal Scaling)                │   │
│   └────────────────────────────────────────────────────────────────────────────────────┘   │
│                                                                                              │
└─────────────────────────────────────────────────────────────────────────────────────────────┘

Distributed Components

Component	Description	Servers	Scalability
PostgreSQL HA Cluster	High availability database with Patroni + Etcd	3 nodes	Replica scaling
File Server Cluster	GlusterFS distributed storage for recordings	3 nodes (or NAS)	Storage scaling
Admin Server	Web dashboard + API backend	1+ nodes	Horizontal scaling
Portal Server	User self-service portal	1+ nodes	Horizontal scaling
Switchboard Server	Operator console	1+ nodes	Horizontal scaling
Telephony Server(s)	FreeSWITCH call processing	N+1 nodes	Unlimited scaling

Telephony Server Scaling

Servers	Extensions	Concurrent Calls	Use Case
1	~10,000	~1,500	Medium Enterprise
2	~20,000	~3,000	Large Enterprise
5	~50,000	~7,500	Service Provider
10+	~100,000+	~15,000+	Carrier Grade

> 💡 Horizontal Scaling: Add telephony servers as your capacity needs grow. Each server operates independently while sharing the same database and configuration.

---

📖 Installation Guides

Single Server

Guide	Description
📖 Single Server Installation	Complete step-by-step guide

Distributed Deployment

Guide	Description
📖 1. PostgreSQL HA Cluster	Database cluster with automatic failover
📖 2. File Server Cluster	Distributed storage (GlusterFS or NAS)
📖 3. Admin Server	Web dashboard and API
📖 4. Portal Server	User self-service portal
📖 5. Switchboard Server	Operator console
📖 6. Telephony Server(s)	FreeSWITCH nodes (N+1)
📖 7. HAProxy Load Balancer	Database routing and application load balancing

---

🔧 Prerequisites

All Deployments

Operating System: Debian 13 (Trixie) - 64-bit
Network: Static IP address(es)
DNS: Domain name(s) configured (recommended)
SSL: Valid SSL certificates (Let's Encrypt supported)

Ring2All Repository Access

Bash

# Add GPG key
curl -fsSL https://repo.ring2all.com/gpg.key | gpg --dearmor -o /etc/apt/keyrings/ring2all.gpg

# Add repository
echo "deb [signed-by=/etc/apt/keyrings/ring2all.gpg] https://repo.ring2all.com/apt stable main" > /etc/apt/sources.list.d/ring2all.list

# Update package list
apt update

---

📦 Package Reference

Package	Description	Required For
`softswitch-db`	Database schemas and migrations	Database Server
`softswitch-admin`	Admin UI + Portal + Switchboard	Web Servers
`softswitch-api`	Backend API service	API Server
`softswitch-telephony`	FreeSWITCH + Lua scripts	Telephony Server
`softswitch-music`	Hold music audio files	All (optional)
`softswitch-voiceguide-emma`	English voice prompts	All (optional)
`softswitch-voiceguide-paloma`	Spanish voice prompts	All (optional)

---

🔐 Post-Installation

After installation:

Access the Admin Dashboard at https://your-server/admin
Activate License in Settings > System > Licensing
Configure SIP Profiles for your network
Create Extensions and test registration
Add Gateways for external calling

---

🆘 Troubleshooting

Common issues and solutions:

Issue	Solution
Services not starting	Check logs: `journalctl -u softswitch-api -f`
Database connection failed	Verify credentials in `/etc/softswitch/db-credentials`
FreeSWITCH not loading	Test ODBC: `isql -v ss_telephony`
Web interface not accessible	Check Nginx: `nginx -t && systemctl status nginx`

--- Next: Single Server Installation or Distributed Deployment Overview