Open Source · Self-Hosted · Docker

Deine Telefonanlage.
Modern verwaltet.

GonoPBX ist eine webbasierte Verwaltungsoberfläche für Asterisk – ein Freizeitprojekt, das stück für Stück wächst. Nebenstellen, SIP-Trunks, Rufumleitungen, Voicemail und Anrufverlauf – alles über eine intuitive Web-GUI. Das Projekt ist noch im Aufbau und ich bin immer offen für neue Ideen – wenn du einen Vorschlag hast, schreib mir gerne. Ich setze ihn um, sobald ich die Zeit dafür finde.

Live-Demo testen Jetzt installieren Handbuch (PDF) Handbuch (Markdown)
Home Assistant Works with Home Assistant Sensoren, MQTT-Events & Anrufe aus dem Smart Home steuern
GonoPBX Dashboard

Neu im Blog

Das wichtigste Release im Überblick.

Alles was du brauchst

Verwalte deine gesamte Telefonanlage über eine zentrale, moderne Weboberfläche.

📞

Nebenstellen →

SIP-Accounts anlegen, bearbeiten und löschen. Jede Nebenstelle mit eigener Caller-ID, Kontext und Aktivierungsstatus.
🔌

SIP-Trunks →

Verbindung zu SIP-Providern per Registrierung oder IP-Authentifizierung. Unterstützung für Plusnet IPfonie und weitere Anbieter.

 Neu
🔍

SIP Debug →

Live-Ansicht aller SIP-Nachrichten direkt im Browser. Nach Call-ID gruppiert, mit expandierbarem Roh-SIP-Text – ohne SSH.
📠

Rufnummern-Zuordnung →

Eingehende Rufnummern (DIDs) flexibel Nebenstellen zuordnen. Nummernblock-Verwaltung pro Trunk.
🔄

Rufumleitungen →

Sofort-, Besetzt- und Nichtmelden-Weiterleitungen pro Nebenstelle. Aktivierung per Toggle.
📩

Voicemail →

Voicemail-Mailbox pro Nebenstelle mit PIN, E-Mail-Benachrichtigung und integriertem Audio-Player.
📊

Anrufverlauf →

Vollständiger Call Detail Record mit Filter nach Quelle, Ziel und Status. Statistiken auf einen Blick.
🔐

Benutzer & Rollen →

Mehrbenutzersystem mit Admin- und User-Rollen. JWT-basierte Authentifizierung.
📡

Live-Dashboard →

Echtzeit-Übersicht: Asterisk-Status, registrierte Endpunkte, aktive Leitungen und letzte Anrufe per WebSocket.
📴

Ausgehende Caller-ID →

Pro Nebenstelle wählen, welche Rufnummer bei ausgehenden Anrufen angezeigt wird. Optional mit P-Asserted-Identity-Header.
🐳

Docker Deployment →

Komplettes System per docker compose up in Minuten einsatzbereit. Automatischer Installer inklusive.
0
Releases
0
Features
0
Technologien
0
% Open Source

Ein Blick ins System

Sieh dir GonoPBX in Aktion an – vom Live-Dashboard bis zur Server-Verwaltung.

Live-Dashboard

Alles Wichtige auf einen Blick: Persönliche Begrüßung, Systemstatus, registrierte Endpunkte und die letzten Anrufe – live per WebSocket aktualisiert.

  • Asterisk-Status und Versionsnummer
  • Leitungen und Nebenstellen mit Rufnummern
  • Letzte ein- und ausgehende Anrufe
GonoPBX Live-Dashboard

Zentrale Einstellungen

Alle Konfigurationsbereiche übersichtlich in einem Tab-Layout: Nebenstellen, Leitungen, Benutzer, E-Mail, Audio, Sicherheit und Server.

  • Nebenstellen mit Status und Caller-ID
  • Neue Nebenstellen in Sekunden anlegen
  • Automatische PJSIP-Konfiguration
Einstellungen Übersicht

Benutzerverwaltung

Neue Benutzer mit Profilbild, Rolle und Nebenstellen-Zuordnung anlegen. Zugangsdaten werden automatisch per E-Mail versendet.

  • Admin- und User-Rollen
  • Profilbild-Upload und Nebenstellen-Zuweisung
  • Willkommens-E-Mail mit Zugangsdaten
Neuen Benutzer anlegen

E-Mail & Audio

SMTP-Server für Voicemail-Benachrichtigungen konfigurieren und Audio-Codecs global festlegen – einzelne Nebenstellen können die Einstellung überschreiben.

  • SMTP mit TLS und Test-E-Mail-Versand
  • Codecs: G.711, G.722, Opus, G.729, GSM
  • Globale und pro-Nebenstelle Codec-Auswahl
E-Mail-Konfiguration

Sicherheit

IP-Whitelist für SIP-Registrierungen, Prüfung schwacher Passwörter und integriertes Fail2Ban-Management – alles in einer Übersicht.

  • IP-Whitelist mit CIDR-Unterstützung
  • SIP-Passwort-Stärkeprüfung
  • Fail2Ban: Jails, aktive Bans und Entbannen per Klick
Sicherheitseinstellungen

Server-Verwaltung

Systemstatus mit Versionsnummer, Uptime, Festplatten- und RAM-Auslastung. Updates prüfen und installieren – direkt aus der Weboberfläche.

  • Version, Uptime und Ressourcen-Monitor
  • Ein-Klick-Updates aus dem Web-GUI
  • Server-Neustart über die Oberfläche
Server-Verwaltung

Technologie

Aufgebaut auf bewährten Open-Source-Technologien.

Asterisk 20 LTS

Bewährtes Open-Source PBX-System mit PJSIP

FastAPI

Modernes Python-Backend mit automatischer API-Dokumentation

React & TypeScript

Schnelles, typsicheres Frontend mit Vite und Tailwind CSS

Docker Compose

Ein Befehl, alles läuft: Asterisk, Backend, Frontend, Datenbank

PostgreSQL

Zuverlässige Datenbank für Konfiguration und Anrufhistorie

JWT Auth

Sichere Authentifizierung mit JSON Web Tokens und bcrypt

WebSocket

Echtzeit-Updates für Anrufstatus und Asterisk-Events

Let's Encrypt

Automatische SSL-Zertifikate für sicheren HTTPS-Zugriff

Works with Home Assistant

Smart Home trifft Telefonanlage

Integriere GonoPBX in dein Home Assistant – Anrufstatus als Sensor, Echtzeit-Events für Automationen und Anrufe direkt aus dem HA-Dashboard starten.

  • Nebenstellen & Trunks als Binary Sensors
  • Aktive Anrufe, Anrufverlauf & Voicemail als Sensoren
  • Echtzeit-Events per MQTT (Anruf gestartet, beendet, verpasst)
  • Services: Anruf starten & Rufumleitung schalten
Anleitung lesen GitHub Repository
GonoPBX Entities
GonoPBX System Connected
Ext 1001 (Büro) Online
Trunk Plusnet Registered
Active Calls 1
Calls Today 12
Voicemail Unread 3

In 3 Schritten einsatzbereit

GonoPBX lässt sich in wenigen Minuten auf jedem Linux-Server installieren.

VPS & Cloud Hetzner, Netcup, DigitalOcean, AWS, Azure
Raspberry Pi Pi 4 & Pi 5 (ARM64) – perfekt fürs Homelab
Dedizierter Server Bare-Metal mit Ubuntu, Debian oder jeder Linux-Distro
Proxmox & VM LXC-Container oder VM – ideal für Homelabs

Voraussetzungen: Linux (x86_64 oder ARM64), Docker & Docker Compose. Mindestens 1 GB RAM und 5 GB Speicher.

1

Repository klonen

Lade den Quellcode von GitHub herunter.

# Repository klonen
git clone https://github.com/ankaios76/gonopbx.git
cd gonopbx
2

Installer starten

Der interaktive Installer erkennt deine Server-IP, generiert sichere Passwörter und erstellt die Konfiguration.

# Installer ausführen
chmod +x install.sh
./install.sh
3

Fertig!

GonoPBX startet automatisch. Öffne deinen Browser und melde dich mit den generierten Admin-Zugangsdaten an.

# Zugriff über Browser
https://deine-server-ip:3000

☕

GonoPBX unterstützen

GonoPBX ist ein Open-Source-Freizeitprojekt – kostenlos und werbefrei. Wenn dir das Projekt gefällt, kannst du die Weiterentwicklung mit einem Kaffee unterstützen.

Dein Beitrag hilft bei Hosting, Domain-Kosten und motiviert zur Weiterentwicklung.

☕ Kaffee 5 € Ein Dankeschön für die Arbeit ⭐ Supporter 10 € Hosting & Domain für einen Monat 🚀 Super-Fan 25 € Treibt die Entwicklung richtig voran

Mehr erfahren & andere Wege zu helfen →