Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Installer sur un VPS

Le cas le plus courant : un VPS chez l’hébergeur de votre choix (OVH, Scaleway, Hetzner, Ionos…), installé avec le modèle Debian 13 standard de l’hébergeur. Une commande y installe Kanadr ; à la fin, la machine est dans le même état qu’une VM issue de l’image après son premier démarrage.

Le VPS

  • Debian 13 (trixie), amd64, le modèle de l’hébergeur tel quel, sans autre logiciel ;
  • 2 vCPU, 4 Go de mémoire et 20 Go libres au moins (voir Dimensionnement) ;
  • une adresse IPv4 publique et un accès SSH (root, ou un compte avec sudo, par la clé que l’hébergeur a déposée) ;
  • un nom complet pour la machine (pbx.operateur.exemple), avec son enregistrement DNS (A) vers l’adresse du VPS : de préférence avant l’installation, sinon avant l’étape Certificat de l’assistant.

En une commande

Connecté en SSH au VPS :

curl -fsSL https://apt.kanadr.com/installer.sh | sudo bash -s -- --nom pbx.operateur.exemple

Comptez 10 à 20 minutes. L’installeur :

  1. vérifie la machine (ci-dessous) et s’arrête net si elle ne convient pas, avant de rien changer ;
  2. donne le nom à la machine (hostname, /etc/hosts), et le garde aux redémarrages si l’hébergeur a installé cloud-init ;
  3. déclare le dépôt de mises à jour (signé) ;
  4. télécharge le moteur de téléphonie et les fichiers d’installation de la même construction que l’image, et vérifie leurs empreintes SHA-256 ;
  5. fait la même installation que l’image : paquets Debian, moteur de téléphonie, Kanadr, nginx, voix de synthèse ;
  6. lance le premier démarrage : secrets propres à la machine, base, réglages du moteur de téléphonie, volume des enregistrements, services (voir Premier démarrage) ;
  7. affiche le lien de mise en route, sous le nom et sous l’adresse IP, les ports à ouvrir et la commande de vérification :
Kanadr est installé : pbx.operateur.exemple (192.0.2.10)

Mise en route de Kanadr / Kanadr setup
Ouvrir / Open : https://pbx.operateur.exemple/mise-en-route#…
…
Ou par l'adresse IP / Or by IP address :
  https://192.0.2.10/mise-en-route#…

Ports à ouvrir vers la machine (pare-feu de l'hébergeur) :
  443/tcp et 80/tcp              portail, API, certificat Let's Encrypt
…
Vérifier la machine : sudo kanadr verifier

Ouvrez le lien, puis suivez le Démarrage rapide à partir de l’étape 3. Le lien se retrouve à chaque connexion SSH ; un nouveau : sudo kanadr mise-en-route.

Le réseau, SSH, les comptes et la clé SSH restent ceux de l’hébergeur : l’installeur n’y touche pas. Pour lire le script avant de le lancer : curl -fsSLO https://apt.kanadr.com/installer.sh, puis sudo bash installer.sh --nom ….

OptionPour
--nomNom complet de la machine (obligatoire) : il donne l’adresse du portail et le domaine par défaut.
--versionUne version précise (la dernière par défaut ; seule la dernière construction est publiée).
--sans-enregistrementsAucun volume dédié aux enregistrements d’appels (voir plus bas).
--essaiVérifie la machine et affiche les commandes, sans rien changer.
--forcerPasse outre des ressources insuffisantes ou une machine déjà occupée. Dangereux : ce qui existe peut cesser de marcher.

Vérifications

L’installeur refuse, avec un message qui dit quoi faire :

  • sans root ni sudo ;
  • hors de Debian 13, ou hors d’amd64 ;
  • sous 2 vCPU, 3,5 Go de mémoire ou 20 Go libres (--forcer pour passer outre) ;
  • sur une machine déjà occupée : Kanadr ou un moteur de téléphonie présents, PostgreSQL avec des bases, nginx configuré, Apache, ou un autre service sur les ports 80, 443, 5060, 5061 ou 5080 (--forcer pour passer outre). Il ne casse jamais un serveur existant : réinstallez plutôt le VPS avec le modèle Debian 13.

Un nom qui ne résout pas encore vers le VPS ne bloque pas : un avertissement le signale, et le lien par l’adresse IP marche sans.

Coupure, relance

Si la connexion SSH tombe ou si une étape échoue, relancez la même commande : l’installation reprend où elle en était (sous le même nom), premier démarrage compris. Le journal de l’installation est dans /var/log/kanadr-installation.log, celui du premier démarrage dans journalctl -u kanadr-premier-demarrage. Pour une longue installation sur une connexion fragile, lancez-la dans tmux ou screen.

Relancée sur une machine installée, la commande ne change rien et affiche de nouveau le lien de mise en route.

Volume des enregistrements

Les enregistrements d’appels vont sur leur propre volume (Volume des enregistrements) : un second disque vide, s’il y en a un, sinon un fichier de la moitié de la place restante (50 Go au plus ; aucun sous 2 Go). --sans-enregistrements : aucun volume dédié, à créer plus tard par kanadr-volume-enregistrements creer.

Ensuite

  • Pare-feu de l’hébergeur : ouvrir les ports de Prérequis (le pare-feu réseau d’OVH, par exemple, se règle dans l’espace client, par adresse IP).
  • DNS : l’enregistrement A du nom vers le VPS, et l’enregistrement générique des domaines des clients (*.pbx.operateur.exemple).
  • Puis l’assistant : certificat Let’s Encrypt, e-mails, fournisseur, premier client.

Limites

  • IPv6 : non réglée par l’installeur ; le portail et le SIP marchent en IPv4.
  • Traduction d’adresses (VPS dont l’adresse publique n’est pas portée par l’interface) : le lien est donné sous l’adresse privée ; ouvrez-le sous l’adresse publique, et réglez l’adresse annoncée par le moteur de téléphonie (sudo kanadr adresse-publique, voir Prérequis).
  • Actif/passif : deux VPS sur le même réseau, avec une adresse IP déplaçable entre eux ; peu d’hébergeurs le permettent (voir Actif/passif).
  • Disque agrandi chez l’hébergeur : le système s’étend comme le prévoit son modèle Debian ; le volume des enregistrements, lui, par kanadr-volume-enregistrements agrandir.