Guide d'installation

Installer MaxiPBX sur votre serveur

Dix étapes, du nom de domaine de votre PBX à votre premier accès à l'interface. Vous préparez d'abord le FQDN et le pare-feu, le Control Plane génère ensuite un script unique que vous lancez en SSH, puis un assistant web prend le relais pour la configuration.

Avant de commencer

  • Un serveur Debian 13 fraîchement installé, sans autre service ni application dessus.
  • Un accès SSH avec le compte root (ou un compte pouvant devenir root).
  • Un nom de domaine dont vous gérez la zone DNS, pour créer le FQDN de votre PBX (par exemple pbx.votredomaine.com).
  • Un compte sur le Control Plane MaxiPBX, à l'adresse my.maxipbx.com.
  • L'accès au pare-feu ou au routeur placé devant le serveur, pour ouvrir les ports nécessaires.
Avant l'installation

Préparer le réseau

  1. Étape 1 : Créez le FQDN de votre serveur

    Avant toute chose, donnez un nom complet (FQDN) à votre PBX, par exemple pbx.votredomaine.com. Dans la zone DNS de votre domaine, faites pointer ce nom vers l'adresse IP de votre serveur :

    AttentionLe FQDN doit déjà pointer vers votre serveur au moment où vous lancez l'installation (étape 8). Créez-le en premier.

    NomTypeValeur
    pbx.votredomaine.com A Adresse IPv4 de votre serveurObligatoire
    pbx.votredomaine.com AAAA Adresse IPv6 de votre serveurSi votre serveur a une IPv6

    AstuceUne modification DNS peut mettre quelques minutes à se propager. Pour vérifier que le nom répond bien avec l'IP de votre serveur, lancez « ping pbx.votredomaine.com » depuis votre poste.

  2. Étape 2 : Ouvrez les ports du pare-feu

    Le PBX a son propre pare-feu, qui ouvre exactement les ports dont il a besoin. Si un pare-feu ou un routeur est placé devant lui (pare-feu de l'hébergeur, routeur d'entreprise, box internet), ouvrez-y tous les ports ci-dessous, depuis l'extérieur vers le PBX.

    AttentionLe port 8443 TCP n'est nécessaire qu'au moment de l'installation : c'est celui de l'assistant d'installation (étape 10). Ouvrez-le avant de lancer l'installation, puis refermez-le une fois le PBX activé : il ne sert plus.

    PortProtocoleServiceÀ quoi ça sert
    8443 Uniquement pendant l'installation TCP Assistant Assistant d'installation (étape 10). À refermer une fois le PBX activé
    80 TCP Nginx Provisioning des postes en HTTP, renouvellement du certificat Let's Encrypt
    443 TCP Nginx Interface web, API, applis mobile et bureau, téléphone web (WebRTC), provisioning HTTPS
    5060 UDP + TCP Kamailio SIP : postes, softphones, trunks opérateurs
    5061 TCP Kamailio SIP chiffré (TLS), certificat ECDSA
    5062 TCP Kamailio SIP chiffré (TLS), certificat RSA pour les postes qui ne gèrent pas l'ECDSA
    30000-40000 UDP rtpengine Voix (RTP) de tous les appels : sans ces ports, pas de son
    3478-3479 UDP + TCP coturn STUN/TURN : son des applis et du téléphone web derrière un NAT
    5349-5350 UDP + TCP coturn TURN chiffré (TLS), même rôle sur les réseaux restrictifs
    389 TCP API MaxiPBX Annuaire LDAP pour les téléphones
    10389 TCP API MaxiPBX Annuaire LDAP sur port alternatif, pour certains modèles
    22 TCP SSH Administration et maintenance à distance par MaxiPBX. Peut être limité à nos adresses IP

    AstuceSi le PBX est derrière un NAT (adresse IP privée), faites une redirection de ports de toute cette liste vers son IP interne, avec la même plage RTP 30000-40000 UDP.

Dans le Control Plane

Générer votre clé d'installation

  1. Étape 3 : Connectez-vous au Control Plane

    Ouvrez my.maxipbx.com dans votre navigateur et connectez-vous avec votre compte. C'est depuis le Control Plane que vous gérez l'ensemble de votre parc de PBX.

    Ouvrir le Control Plane
  2. Étape 4 : Ouvrez la liste de vos PBX

    Dans le menu, allez dans « Parc PBX », puis cliquez sur « PBX ». Vous y voyez tous les PBX déjà rattachés à votre compte.

  3. Étape 5 : Générez une clé d'installation

    Cliquez sur « Générer une clé d'installation ». Cette clé relie le futur serveur à votre compte : une fois installé, il apparaîtra directement dans votre parc.

  4. Étape 6 : Affichez et copiez le script d'installation

    Affichez le script d'installation et copiez-le en entier. Il contient déjà votre clé : vous n'avez rien à y modifier.

    AttentionLe script contient une clé propre à votre compte. Ne le partagez pas et ne le publiez nulle part.

Sur votre serveur

Lancer l'installation

  1. Étape 7 : Connectez-vous en SSH avec le compte root

    Depuis un terminal (ou un client comme PuTTY sous Windows), connectez-vous à votre serveur Debian 13 tout neuf avec le compte root. Remplacez VOTRE_IP par l'adresse IP de votre serveur.

    ssh root@VOTRE_IP

    AstuceSi vous êtes connecté avec un autre compte, passez root avec la commande « su - » ou « sudo -i » avant de continuer.

  2. Étape 8 : Collez le script et validez

    Collez le script d'installation copié à l'étape 6 dans le terminal, puis appuyez sur Entrée.

  3. Étape 9 : Laissez l'installation se dérouler

    L'installation s'affiche à l'écran au fur et à mesure. Laissez-la aller jusqu'au bout sans rien toucher.

    AttentionNe fermez pas le terminal et ne coupez pas la connexion SSH pendant l'installation.

Dans votre navigateur

Finaliser la configuration

  1. Étape 10 : Ouvrez l'assistant d'installation

    À la fin de l'installation, le terminal affiche l'adresse de votre PBX, sous la forme ci-dessous. Ouvrez-la dans votre navigateur, puis suivez l'assistant d'installation : il vous guide pour la configuration de départ.

    https://VOTRE_IP:8443

    AstuceSi votre navigateur affiche un avertissement de sécurité sur le certificat lors de ce premier accès, vous pouvez poursuivre vers le site pour lancer l'assistant.

    Besoin d'aide ?En cas de doute pendant l'assistant, n'hésitez pas à contacter votre partenaire revendeur MaxiPBX : il est là pour vous accompagner.

Votre PBX est installé

Une fois l'assistant terminé, votre PBX est prêt et rattaché à votre parc dans le Control Plane. Vous pouvez créer vos utilisateurs, vos postes et vos lignes.

Besoin d'un coup de main ?

Notre équipe peut vous accompagner pendant l'installation ou s'en charger pour vous.