Installationsanleitung

MaxiPBX auf Ihrem Server installieren

Zehn Schritte, vom Domainnamen Ihrer PBX bis zum ersten Zugriff auf die Oberfläche. Zuerst bereiten Sie den FQDN und die Firewall vor, dann erzeugt das Control Plane ein einmaliges Skript, das Sie per SSH ausführen, und schliesslich übernimmt ein Webassistent die Konfiguration.

Bevor Sie beginnen

  • Ein frisch installierter Debian-13-Server, auf dem kein anderer Dienst und keine andere Anwendung läuft.
  • Ein SSH-Zugang mit dem Konto root (oder einem Konto, das zu root wechseln kann).
  • Ein Domainname, dessen DNS-Zone Sie verwalten, um den FQDN Ihrer PBX anzulegen (zum Beispiel pbx.yourdomain.com).
  • Ein Konto im MaxiPBX Control Plane unter my.maxipbx.com.
  • Zugriff auf die Firewall oder den Router vor dem Server, um die erforderlichen Ports zu öffnen.
Vor der Installation

Netzwerk vorbereiten

  1. Schritt 1 : Legen Sie den FQDN Ihres Servers an

    Geben Sie Ihrer PBX zunächst einen vollqualifizierten Domainnamen (FQDN), zum Beispiel pbx.yourdomain.com. Lassen Sie diesen Namen in der DNS-Zone Ihrer Domain auf die IP-Adresse Ihres Servers zeigen:

    AchtungDer FQDN muss bereits auf Ihren Server zeigen, wenn Sie die Installation starten (Schritt 8). Legen Sie ihn als Erstes an.

    NameTypWert
    pbx.yourdomain.com A IPv4-Adresse Ihres ServersErforderlich
    pbx.yourdomain.com AAAA IPv6-Adresse Ihres ServersFalls Ihr Server eine IPv6-Adresse hat

    TippEine DNS-Änderung kann einige Minuten dauern, bis sie sich verbreitet hat. Um zu prüfen, ob der Name mit der IP Ihres Servers antwortet, führen Sie auf Ihrem Rechner „ping pbx.yourdomain.com“ aus.

  2. Schritt 2 : Öffnen Sie die Firewall-Ports

    Die PBX verfügt über eine eigene Firewall, die genau die benötigten Ports öffnet. Befindet sich davor eine Firewall oder ein Router (Firewall des Hosting-Anbieters, Firmenrouter, Internet-Router), öffnen Sie dort alle unten aufgeführten Ports von aussen zur PBX.

    AchtungPort 8443 TCP wird nur während der Installation benötigt: Er wird vom Installationsassistenten verwendet (Schritt 10). Öffnen Sie ihn vor dem Start der Installation und schliessen Sie ihn nach der Aktivierung der PBX wieder: Er wird dann nicht mehr benötigt.

    PortProtokollDienstWozu er dient
    8443 Nur während der Installation TCP Assistent Installationsassistent (Schritt 10). Nach der Aktivierung der PBX wieder schliessen
    80 TCP Nginx Provisionierung der Endgeräte über HTTP, Erneuerung des Let's-Encrypt-Zertifikats
    443 TCP Nginx Weboberfläche, API, Mobil- und Desktop-Apps, Webtelefon (WebRTC), HTTPS-Provisionierung
    5060 UDP + TCP Kamailio SIP: Endgeräte, Softphones, Provider-Trunks
    5061 TCP Kamailio Verschlüsseltes SIP (TLS), ECDSA-Zertifikat
    5062 TCP Kamailio Verschlüsseltes SIP (TLS), RSA-Zertifikat für Endgeräte, die ECDSA nicht unterstützen
    30000-40000 UDP rtpengine Sprache (RTP) aller Gespräche: ohne diese Ports kein Ton
    3478-3479 UDP + TCP coturn STUN/TURN: Ton der Apps und des Webtelefons hinter NAT
    5349-5350 UDP + TCP coturn Verschlüsseltes TURN (TLS), gleiche Funktion in restriktiven Netzwerken
    389 TCP MaxiPBX API LDAP-Verzeichnis für die Telefone
    10389 TCP MaxiPBX API LDAP-Verzeichnis auf alternativem Port, für bestimmte Modelle
    22 TCP SSH Fernadministration und -wartung durch MaxiPBX. Kann auf unsere IP-Adressen beschränkt werden

    TippBefindet sich die PBX hinter NAT (private IP-Adresse), richten Sie für diese gesamte Liste eine Portweiterleitung auf ihre interne IP ein, mit demselben RTP-Bereich 30000-40000 UDP.

Im Control Plane

Installationsschlüssel erzeugen

  1. Schritt 3 : Melden Sie sich im Control Plane an

    Öffnen Sie my.maxipbx.com in Ihrem Browser und melden Sie sich mit Ihrem Konto an. Im Control Plane verwalten Sie Ihren gesamten PBX-Bestand.

    Control Plane öffnen
  2. Schritt 4 : Öffnen Sie die Liste Ihrer PBX

    Gehen Sie im Menü zu „PBX-Bestand“ und klicken Sie dann auf „PBX“. Dort sehen Sie alle PBX, die bereits mit Ihrem Konto verknüpft sind.

  3. Schritt 5 : Erzeugen Sie einen Installationsschlüssel

    Klicken Sie auf „Installationsschlüssel erzeugen“. Dieser Schlüssel verknüpft den künftigen Server mit Ihrem Konto: Nach der Installation erscheint er direkt in Ihrem Bestand.

  4. Schritt 6 : Zeigen Sie das Installationsskript an und kopieren Sie es

    Zeigen Sie das Installationsskript an und kopieren Sie es vollständig. Es enthält bereits Ihren Schlüssel: Sie müssen nichts daran ändern.

    AchtungDas Skript enthält einen Schlüssel, der Ihrem Konto eindeutig zugeordnet ist. Geben Sie es nicht weiter und veröffentlichen Sie es nirgends.

Auf Ihrem Server

Installation starten

  1. Schritt 7 : Verbinden Sie sich per SSH mit dem Konto root

    Verbinden Sie sich von einem Terminal aus (oder mit einem Client wie PuTTY unter Windows) mit dem Konto root mit Ihrem neuen Debian-13-Server. Ersetzen Sie YOUR_IP durch die IP-Adresse Ihres Servers.

    ssh root@YOUR_IP

    TippWenn Sie mit einem anderen Konto angemeldet sind, wechseln Sie vor dem Fortfahren mit dem Befehl „su -“ oder „sudo -i“ zu root.

  2. Schritt 8 : Fügen Sie das Skript ein und bestätigen Sie

    Fügen Sie das in Schritt 6 kopierte Installationsskript in das Terminal ein und drücken Sie dann die Eingabetaste.

  3. Schritt 9 : Lassen Sie die Installation durchlaufen

    Der Fortschritt der Installation wird laufend auf dem Bildschirm angezeigt. Lassen Sie sie vollständig durchlaufen, ohne etwas zu verändern.

    AchtungSchliessen Sie das Terminal nicht und unterbrechen Sie die SSH-Verbindung während der Installation nicht.

In Ihrem Browser

Konfiguration abschliessen

  1. Schritt 10 : Öffnen Sie den Installationsassistenten

    Am Ende der Installation zeigt das Terminal die Adresse Ihrer PBX in der unten dargestellten Form an. Öffnen Sie sie in Ihrem Browser und folgen Sie dem Installationsassistenten: Er führt Sie durch die Erstkonfiguration.

    https://YOUR_IP:8443

    TippZeigt Ihr Browser bei diesem ersten Zugriff eine Sicherheitswarnung zum Zertifikat an, können Sie zur Website fortfahren, um den Assistenten zu starten.

    Brauchen Sie Hilfe?Wenden Sie sich bei Unklarheiten während des Assistenten jederzeit an Ihren MaxiPBX-Vertriebspartner: Er unterstützt Sie gerne.

Ihre PBX ist installiert

Sobald der Assistent abgeschlossen ist, ist Ihre PBX einsatzbereit und im Control Plane mit Ihrem Bestand verknüpft. Sie können nun Ihre Benutzer, Endgeräte und Leitungen anlegen.

Brauchen Sie Unterstützung?

Unser Team kann Sie bei der Installation begleiten oder sie für Sie übernehmen.