Installieren des 3CX SBC auf einem Raspberry Pi 5

Einführung

Diese Anleitung beschreibt die Installation des 3CX SBC auf einem Raspberry Pi 5.

Der 3CX SBC unterstützt die auf Debian 12 (Bookworm) und Debian 13 (Trixie) basierenden Raspberry Pi-Betriebssysteme.

Schritt 1: Auswählen eines geeigneten Raspberry Pi

  • Ein Raspberry Pi 5 – 4 GB/8 GB
  • Eine hochwertige, idealerweise mit hoher Speicherausdauer, microSD-Karte.
  • Die Mindestkapazität beträgt 32 GB; für größere Protokolldateien zur Fehlerbehebung empfiehlt sich eine größere Speicherkapazität.
  • Stellen Sie sicher, dass das Gerät ein gutes Gehäuse hat, das eine maximale Kühlung ermöglicht
  • Ein aktiv gekühltes Gehäuse oder ein Raspberry Pi Active Cooler.
  • Ein hochwertiges 5V, 5A USB-C-Netzteil.
  • Idealerweise das offizielle Netzteil für den Raspberry Pi 5.

Schritt 2: Vorbereiten einer SD-Karte mit Raspberry Pi OS

  • Laden Sie den Raspberry Pi Imager herunter und installieren Sie ihn. Die vollständige Dokumentation finden Sie auf der verlinkten Seite.
  • Starten Sie den Imager, wählen Sie Raspberry Pi 5 aus und klicken Sie auf NEXT..

Raspberry Pi Imager

  • Scrollen Sie auf der OS-Karte nach unten und wählen Sie Raspberry Pi OS (andere) aus und klicken Sie darauf.

Raspberry Pi OS

  • Wählen Sie das passende Debian Bookworm oder Trixie Raspberry Pi OS Lite für Ihren Raspberry Pi und klicken Sie auf NEXT..
  • 64-Bit (arm64) – Empfohlen. Verwenden Sie diese Option für alle Neuinstallationen des Raspberry Pi 5. Diese Architektur wurde von 3CX getestet und validiert.
  • 32-Bit (armhf) – Nur für ältere Systeme. Die 32-Bit-Version funktioniert möglicherweise weiterhin, wird aber nicht mehr von 3CX getestet oder validiert. Zukünftige Kompatibilität kann nicht garantiert werden.

Speicher auswählen

  • Wählen Sie die SD-Karte aus, die Sie vorbereiten möchten.
  • Lassen Sie Exclude system drives aktiviert, um versehentliche Beschädigungen Ihrer Systemlaufwerke zu vermeiden.
  • Bestätigen Sie Ihre Auswahl.
  • Es empfiehlt sich, die Anpassungsschritte jetzt durchzuführen. Wenn Sie diese überspringen, wird beim ersten Start des Raspberry Pi ein Assistent mit denselben Optionen ausgeführt.

Anpassungsschritte

  • Geben Sie einen Hostnamen ein.
  • Stellen Sie Ihre Zeitzone und Tastatur ein.
  • Erstellen Sie Ihr Standardbenutzerkonto und vergeben Sie ein sicheres Passwort, das Sie sich merken werden.
  • Der SBC muss per Ethernet-Kabel verbunden sein; WLAN wird nicht unterstützt.
  • Entscheiden Sie, wie Sie sich nach der Installation mit Ihrem Raspberry Pi verbinden möchten:
  • SSH mit Passwort- oder Public-Key-Authentifizierung
  • Raspberry Pi Connect.

Image schreiben

  • Überprüfen Sie, ob die relevanten Informationen in der Zusammenfassung Ihren Erwartungen entsprechen, und schreiben Sie das Image auf Ihre SD-Karte.
  • Der Imager lädt vor dem Schreibvorgang die neueste verfügbare Version aus dem Raspberry-Repository herunter.

Schritt 3: Starten Ihres Raspberry Pi

  • Legen Sie die soeben vorbereitete SD-Karte in den Raspberry Pi ein.
  • Starten Sie den Raspberry Pi.
  • Stellen Sie eine Verbindung über die Konsole, SSH oder Pi Connect her.

Schritt 4: Festlegen einer statischen IP-Adresse

Festlegen einer statischen IP-Adresse

  • Führen Sie den Befehl nmtui aus:

sudo nmtui

  • Wählen Sie „Edit a connection“.
  • Wählen Sie Ihre Netzwerkverbindung aus.
  • Stellen Sie IPv4 auf „Manual“ und klicken Sie auf „ <Show>“.
  • Geben Sie Adresse, Gateway und DNS-Server entsprechend Ihren LAN-Einstellungen ein und klicken Sie auf „<OK>“.
  • Klicken Sie auf „Back“ und „Quit“, um den Assistenten zu schließen.
  • Starten Sie den Raspberry Pi neu.

sudo reboot

  • Wenn der Pi neu gestartet wurde, melden Sie sich mit dem von Ihnen erstellten Nutzer an und überprüfen Sie die IP-Adresse „eth0“:

ip a

Hinweis: LAN-Installationen werden in ordnungsgemäß konfigurierten privaten Netzwerken gemäß RFC 1918 unterstützt:

  • 10.0.0.0/8
  • 172.16.0.0/12
  • 192.168.0.0/16

Schritt 5: Hinzufügen des SBC zu 3CX

Hinzufügen des 3CX SBC

  1. Melden Sie sich am 3CX-Webclient an und navigieren Sie zu "Admin > Trunks & Chat".
  2. Klicken Sie auf "+ SBC", wählen Sie "Raspberry Pi" und klicken Sie auf "Weiter".
  3. Die SBC-Verbindung wurde nun auf der PBX-Seite hergestellt und wartet darauf, dass sich der eigentliche SBC verbindet.

Schritt 6: Installieren des 3CX SBC auf Ihrem Raspberry Pi

  1. Melden Sie sich über die CLI oder SSH mit dem primären Benutzerkonto am Raspberry Pi an.
  2. Führen Sie das 3CX-Installationsskript aus:

sudo bash -c "$(wget -qO- https://downloads-global.3cx.com/downloads/sbc/3cxsbc.zip)"

  1. Wählen Sie „OK“, um die „3CX-Voraussetzungen“ zu überprüfen und die „Endbenutzer-Lizenzvereinbarung“ zu akzeptieren.
  2. Geben Sie die „Bereitstellungs-URL“ für Ihre 3CX-Installation ein (z. B. https://example-pbx.3cx.com) und wählen Sie „OK“.
  3. Geben Sie die „Authentifizierungsschlüssel-ID“ ein und wählen Sie „OK“.
  4. Wählen Sie „OK“ und fahren Sie mit der Installation und dem Neustart fort.

Schritt 7: Provisionieren der IP-Telefone

Provisionieren der IP-Telefone

Sobald Ihr SBC installiert ist, können Sie Ihre IP-Telefone über diesen SBC provisionieren, indem Sie ihn während der IP-Telefon-Einrichtung als Verbindungsoption auswählen.

Siehe auch

Letztes Update

Dieses Dokument wurde zuletzt am 24. Juli 2026 aktualisiert.

https://www.3cx.de/docs/adminhandbuch/telefonanlage-installieren-raspberry-pi/