GonoPBX runs entirely in Docker containers. A single command starts Asterisk, backend, frontend, and database. The interactive installer detects your server IP, generates secure passwords, and creates the full configuration automatically.
What is included?
- Asterisk 20 LTS – PBX server with PJSIP stack
- FastAPI backend – REST API and WebSocket server
- React frontend – Web GUI with Vite and TypeScript
- PostgreSQL – Database for configuration and CDR
- Nginx – Reverse proxy with optional SSL
Supported platforms
| Platform | Details |
|---|---|
| VPS & Cloud | Hetzner, Netcup, DigitalOcean, AWS, Azure |
| Raspberry Pi | Pi 4 & Pi 5 (ARM64) – perfect for homelabs |
| Dedicated server | Bare metal with Ubuntu, Debian, or any Linux distro |
| Proxmox & VM | LXC containers or VM – ideal for homelabs |
Installation
# Clone the repository
git clone https://github.com/ankaios76/gonopbx.git
cd gonopbx
# Run the installer
chmod +x install.sh
./install.sh
# Or manually
cp .env.example .env
docker compose up -d --build
git clone https://github.com/ankaios76/gonopbx.git
cd gonopbx
# Run the installer
chmod +x install.sh
./install.sh
# Or manually
cp .env.example .env
docker compose up -d --build
What does the installer do?
- Detect IP – Automatically determines your external IP address
- Generate passwords – Secure random passwords for DB, AMI, JWT, and admin
- Create .env – All configuration values in one file
- Start containers – Runs
docker compose up -d --buildautomatically
System requirements
- Linux (x86_64 or ARM64)
- Docker & Docker Compose
- At least 1 GB RAM
- At least 5 GB storage
Updates are easy:
git pull && docker compose up -d --build or
directly via Settings → Server → Update in the web GUI.