Open Source · Self-Hosted · Docker

Your phone system.
Modern management.

GonoPBX is a web-based management interface for Asterisk – a side project that grows step by step. Extensions, SIP trunks, call forwarding, voicemail, and call history – all via an intuitive web GUI. The project is still evolving and I am always open to new ideas – if you have a suggestion, feel free to reach out. I will implement it as time allows.

Try Live Demo Install Now Manual (PDF) Manual (Markdown)
Home Assistant Works with Home Assistant Sensors, MQTT events & call control from your smart home
GonoPBX Dashboard

New on the Blog

The most important release at a glance.

Everything You Need

Manage your entire phone system from one modern, central web interface.

📞

Extensions →

Create, edit, and delete SIP accounts. Each extension with its own caller ID, context, and activation status.
🔌

SIP Trunks →

Connect to SIP providers via registration or IP authentication. Built-in support for Plusnet IPfonie and more.

 New
🔍

SIP Debug →

Live view of SIP messages directly in the browser. Grouped by Call-ID, with expandable raw SIP text – no SSH needed.
📠

DID Assignment →

Assign inbound numbers (DIDs) flexibly to extensions. Number block management per trunk.
🔄

Call Forwarding →

Immediate, busy, and no-answer forwarding per extension. Enable with a toggle.
📩

Voicemail →

Per-extension voicemail boxes with PIN, email notifications, and built-in audio player.
📊

Call History →

Complete call detail records with filters by source, destination, and status. Statistics at a glance.
🔐

Users & Roles →

Multi-user system with admin and user roles. JWT-based authentication.
📡

Live Dashboard →

Real-time overview: Asterisk status, registered endpoints, active lines, and recent calls via WebSocket.
📴

Outbound Caller ID →

Choose which DID is shown for outbound calls per extension. Optional P-Asserted-Identity header.
🐳

Docker Deployment →

Full system ready in minutes with docker compose up. Includes an automated installer.
0
Releases
0
Features
0
Technologies
0
% Open Source

A Look Inside

See GonoPBX in action – from the live dashboard to server management.

Live Dashboard

Everything important at a glance: personal greeting, system status, registered endpoints, and recent calls – updated live via WebSocket.

  • Asterisk status and version
  • Trunks and extensions with numbers
  • Recent inbound and outbound calls
GonoPBX Live Dashboard

Central Settings

All configuration areas in a clear tab layout: extensions, lines, users, email, audio, security, and server.

  • Extensions with status and caller ID
  • Create new extensions in seconds
  • Automatic PJSIP configuration
Settings Overview

User Management

Create new users with avatar, role, and extension assignment. Credentials are sent automatically via email.

  • Admin and user roles
  • Avatar upload and extension assignment
  • Welcome email with credentials
Create a new user

Email & Audio

Configure SMTP for voicemail notifications and set audio codecs globally – individual extensions can override the settings.

  • SMTP with TLS and test email
  • Codecs: G.711, G.722, Opus, G.729, GSM
  • Global and per-extension codec selection
Email configuration

Security

IP whitelist for SIP registrations, weak password checks, and integrated Fail2Ban management – all in one view.

  • IP whitelist with CIDR support
  • SIP password strength checks
  • Fail2Ban: jails, active bans, and one-click unban
Security settings

Server Management

System status with version, uptime, disk and RAM usage. Check and install updates directly from the web UI.

  • Version, uptime, and resource monitor
  • One-click updates from the web GUI
  • Server reboot from the interface
Server management

Technology

Built on proven open-source technologies.

Asterisk 20 LTS

Proven open-source PBX with PJSIP

FastAPI

Modern Python backend with automatic API documentation

React & TypeScript

Fast, type-safe frontend with Vite and Tailwind CSS

Docker Compose

One command runs everything: Asterisk, backend, frontend, database

PostgreSQL

Reliable database for configuration and call history

JWT Auth

Secure authentication with JSON Web Tokens and bcrypt

WebSocket

Real-time updates for call status and Asterisk events

Let's Encrypt

Automatic SSL certificates for secure HTTPS access

Works with Home Assistant

Smart Home meets phone system

Integrate GonoPBX into Home Assistant – call status as sensors, real-time events for automations, and start calls directly from your HA dashboard.

  • Extensions & trunks as binary sensors
  • Active calls, call history & voicemail as sensors
  • Real-time events via MQTT (call started, ended, missed)
  • Services: start calls & toggle forwarding
Read the guide GitHub Repository
GonoPBX Entities
GonoPBX System Connected
Ext 1001 (Office) Online
Trunk Plusnet Registered
Active Calls 1
Calls Today 12
Voicemail Unread 3

Ready in 3 Steps

GonoPBX installs in minutes on any Linux server.

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

Requirements: Linux (x86_64 or ARM64), Docker & Docker Compose. At least 1 GB RAM and 5 GB storage.

1

Clone the repository

Download the source code from GitHub.

# Clone repository
git clone https://github.com/ankaios76/gonopbx.git
cd gonopbx
2

Run the installer

The interactive installer detects your server IP, generates secure passwords, and creates the configuration.

# Run installer
chmod +x install.sh
./install.sh
3

Done!

GonoPBX starts automatically. Open your browser and log in with the generated admin credentials.

# Access via browser
https://your-server-ip:3000

☕

Support GonoPBX

GonoPBX is an open-source side project – free and ad-free. If you like the project, you can support continued development with a coffee.

Your contribution helps with hosting, domain costs, and keeps development moving.

☕ Coffee 5 € A thank-you for the work ⭐ Supporter 10 € Hosting & domain for one month 🚀 Super Fan 25 € Pushes development forward

Learn more & other ways to help →