3CX Installation Guide

Schritt-für-Schritt-Anleitung zur Installation von 3CX auf Linux (Debian ISO), Windows Server und Docker. Plus die vollverwaltete Hosting-Option.

Video: 3CX lokal installieren — vollständige deutsche Anleitung.

Überblick

Diese Anleitung behandelt die Installation von 3CX auf verschiedenen Plattformen. 3CX ist eine vielseitige IP-Telefonanlage und läuft als Debian-ISO (empfohlen), als klassisches Linux-Paket, als Windows-Server-Service (Legacy) oder als Docker-Container. Wer den Betrieb komplett auslagern will, kann auf BitBlade-Hosting in Frankfurt, Wien oder Zürich umsteigen.

Systemanforderungen

Linux (Ubuntu/Debian — empfohlen)

• Debian 12 oder Ubuntu 22.04 LTS / 24.04 LTS
• RAM: mindestens 2 GB, empfohlen 4 GB+
• CPU: 2 Kerne (4+ für 100+ Benutzer)
• Speicher: 50 GB (SSD empfohlen)
• Statische IP erforderlich

Windows Server

• Windows Server 2019+
• RAM: mindestens 4 GB
• CPU: 2 x64 Kerne
• Speicher: 50 GB
• .NET Framework 4.8+

Hinweis: Die Windows-Variante wird von 3CX seit V20 stiefmütterlich behandelt — neue Installationen sollten Linux/Docker bevorzugen.

Installation auf Linux (Debian ISO — empfohlen)

Der einfachste Weg ist die offizielle 3CX-Debian-ISO. Sie bringt ein gehärtetes Basis-System mit, auf dem nur 3CX läuft — keine manuelle Paket-Pflege, keine Versionskonflikte, automatische Updates über die 3CX-Pipeline.

Klassisch via Repo (für eigene Linux-Distribution)

sudo apt update && sudo apt upgrade -y

Repository konfigurieren

curl https://repo.3cx.com/gpg-key | sudo apt-key add -
echo "deb [arch=amd64] https://repo.3cx.com/debian $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/3cx.list

Installation

sudo apt update && sudo apt install -y 3cxpbx

Service starten

sudo systemctl start 3cxpbx
sudo systemctl enable 3cxpbx

Installation auf Windows

1. Installer von 3cx.com herunterladen
2. Als Administrator ausführen
3. Installationsassistenten folgen
4. Netzwerkeinstellungen konfigurieren
5. Service starten

Erstkonfiguration

Admin Portal

https://SERVER_IP:5015

Erste Schritte

1. Admin-Passwort ändern
2. Zeitzone einstellen
3. SIP Trunk konfigurieren — siehe SIP-Trunk-Anleitung
4. Benutzer anlegen — siehe Nebenstellen-Wiki

Häufige Fehler

Port 5015 bereits in Verwendung

Ändern Sie den Port oder deaktivieren Sie den konfliktierenden Service. Auf Debian-ISO-Installationen ist dieser Konflikt praktisch ausgeschlossen.

Lizenzverifizierung fehlgeschlagen

Überprüfen Sie die Internetverbindung und die Firewall für ausgehende HTTPS-Verbindungen zu activation.3cx.com. Bei Proxy-Umgebungen den Proxy in den 3CX-Network-Settings setzen.

Best Practices

• Starkes Admin-Passwort — mind. 14 Zeichen, gemischt
• HTTPS für externe Verbindungen — Let's-Encrypt automatisiert in 3CX integriert
• Firewall konfigurieren — nur 5060/5061 (SIP), 5090 (Tunnel) und 443 (Web) öffnen, Rest dicht
• Regelmäßige Backups — täglich, mit verschlüsseltem Off-Site-Storage
• Updates durchführen — 3CX hat eine 1-Click-Update-Mechanik im Admin-Portal