Se rendre au contenu
KanadrKanadr

Installé chez vous, ou hébergé par nous en France.

Le même logiciel dans les deux cas : une VM Debian qui vous est dédiée, avec tous vos revendeurs et clients dedans. À vous de choisir qui l'exploite.

Chez vous

Image prête à l'emploi ou paquet Debian, sur votre hyperviseur : KVM, Proxmox, OpenStack, VMware ou VirtualBox. Vos équipes l'administrent avec leurs outils habituels, et les données ne quittent pas votre infrastructure.

Essai gratuit de 30 jours, sur demande →

Hébergé par nousen option

Une VM qui vous est dédiée, hébergée en France. Nous nous chargeons des mises à jour, de la supervision et des sauvegardes. La haute disponibilité s'ajoute en option.

Installation

De l'image au premier appel : créer l'opérateur et son administrateur, poser le certificat, régler l'e-mail, ouvrir le réseau, puis créer un client, son trunk et un poste.

Image prête

Une VM complète : Debian 13, PostgreSQL, nginx, Kanadr avec son moteur de téléphonie, et la voix de synthèse. En qcow2 pour KVM, Proxmox et OpenStack, en OVA pour VMware et VirtualBox, avec les empreintes SHA-256 à vérifier avant l'import.

Accès

Aucun mot de passe dans l'image : la clé SSH et le nom de la machine se donnent au premier démarrage, par cloud-init ou par les propriétés de l'OVA.

Premier démarrage

La VM tire ses propres secrets (base, accès au moteur de téléphonie, clé de chiffrement), règle la téléphonie et pose le volume des enregistrements. Deux VM issues de la même image ne partagent aucun secret.

Paquet Debian

Pour une machine où la pile téléphonique est déjà installée : apt install kanadr, puis les réglages décrits dans le guide. L'image reste la voie recommandée.

Disque

12 Go au minimum, agrandi au premier démarrage à la taille de la VM. Un second disque vide accueille les enregistrements ; à défaut, un fichier de 50 Go.

Vérification

kanadr verifier contrôle en lecture seule les réglages, le trousseau, la base, le moteur de téléphonie (profils SIP, tickets d'appel), les fichiers, le portail et le service.

Réseau et certificats

Une adresse IP publique fixe, portée de préférence par la VM. La VM n'installe pas de pare-feu : filtrez en amont, ou sur la machine.

PortProtocolePour
443TCPPortail et API (HTTPS)
80TCPRedirection vers HTTPS, validation Let's Encrypt
5060UDP et TCPSIP des téléphones et softphones
5061TCPSIP en TLS des softphones
5080UDP et TCPSIP des trunks, limitable aux adresses du fournisseur
16384 à 32768UDPVoix (RTP)
3478UDP et TCPServeur TURN du téléphone dans le navigateur : STUN et relais
5349TCPTURN en TLS, pour les réseaux qui ne laissent passer que le TLS
40000 à 41999UDPRelais du TURN
22TCPAdministration, depuis vos adresses seulement
112 (IP), 5432VRRP, TCPEntre les deux VM d'un actif/passif
Derrière un NAT

La VM doit annoncer son adresse publique, sinon la voix ne passe que dans un sens. Le guide donne les deux réglages à vérifier.

Domaines

Un nom pour la machine (pbx.votre-marque.fr) et un domaine joker pour les clients : chacun a son domaine SIP (client.pbx.votre-marque.fr), sur lequel ses téléphones s'enregistrent.

Certificat

Le vôtre, ou Let's Encrypt avec renouvellement automatique, transmis à chaque fois au portail et au SIP en TLS.

Connecteurs SIP

Les liaisons vers des services tiers sortent en TLS depuis la machine : aucun port à ouvrir en entrée pour elles.

Téléphonie

Moteur

Voix G.711 relayée, transcodage G.722 et Opus possible. Une VM accepte 1 000 sessions (environ 500 appels établis) et 100 nouvelles sessions par seconde.

Trunks

Un par client, par enregistrement ou par adresse IP : format des numéros appelés et présentés, NDI, hôte du P-Asserted-Identity, réseaux du fournisseur. Un profil réunit ce qui est commun à un fournisseur ; le modifier met à jour tous ses trunks.

Chiffrement

SIP en TLS 1.2 et 1.3 et voix en SRTP pour les softphones SIP, activés par chaque client en un réglage. Le téléphone dans le navigateur est toujours chiffré.

Voix de synthèse

Piper, installée sur la VM, en français et en anglais : annonces, messagerie et salles de conférence, sans service externe.

Destinations bloquées

Des préfixes internationaux refusés pour tous les clients, renvois compris (les satellites en +882 par exemple). Les numéros d'urgence restent toujours joignables.

Langues et fuseaux

Langue réglable par opérateur, par client et par compte : portail, e-mails, annonces et messagerie. Français et anglais livrés, toute autre langue à la demande ; voix de synthèse disponibles dans une trentaine de langues, transcription dans la plupart. Le fuseau horaire de chaque organisation fixe ses horaires d'ouverture, ses dates et ses mois de facturation.

Dimensionnement

Mesuré sur l'image : 50 clients de 20 postes, appels de poste à poste authentifiés, voix G.711 relayée par la VM, qualité calculée sur chaque appel. Le nombre de clients compte peu : c'est le nombre d'appels simultanés qui charge la machine.

VMAppels simultanésPostes (repère)
1 vCPU, 2 Go100700 à 1 000
2 vCPU, 4 Go (image par défaut)2001 300 à 2 000
Qualité

MOS 4,48 tant que le processeur ne sature pas. Au-delà de 250 appels sur 2 vCPU, ou de 125 sur 1 vCPU, elle se dégrade.

Mémoire et enregistrements SIP

Moins de 800 Mo de mémoire à 300 appels. 1 000 téléphones qui se réenregistrent chaque minute font 17 enregistrements par seconde ; une VM de 2 vCPU en absorbe 200.

Quand agrandir

Au-delà de 75 % de processeur en pointe, ajoutez des vCPU. Enregistrement, transcodage, conférences, sonneries de groupe et files d'attente demandent de la marge.

Stockage

16 Mo par heure d'appel enregistré (MP3 stéréo) : 50 Go tiennent environ 3 000 heures. Le volume s'agrandit à chaud.

Exploitation

Mises à jour

Par apt, depuis notre dépôt signé, vérifié chaque jour. Rien ne s'installe tout seul : la nouvelle version est signalée dans le portail et dans la supervision, vous choisissez le moment. La base est photographiée avant chaque migration, le retour à une version antérieure se fait par apt, et vos réglages ne sont jamais réécrits.

Sauvegarde et restauration

kanadr sauvegarder produit à chaud une archive : base entière, trousseau des clés, enregistrements, messagerie, annonces et musiques. La restauration remplace la base en une transaction ; une archive d'une version plus récente est refusée.

Haute disponibilité

Deux VM et une IP flottante. Base répliquée en continu (quelques secondes de retard au plus), fichiers et clés copiés chaque minute. L'active s'annonce chaque seconde ; après 3 secondes de silence, la passive prend la main. Une VM qui ne joint plus son témoin rend l'IP : jamais deux actives.

Ce que coûte une bascule

Le service revient en moins de deux minutes et les téléphones n'ont pas à se réenregistrer. Les appels en cours sont perdus, et au plus la dernière minute de messages vocaux. L'ancienne active revient en passive, sans retour automatique.

Volume des enregistrements

Sur leur propre volume, agrandi à chaud. Plein, il n'empêche que les nouveaux enregistrements : les appels, la base et la messagerie continuent. Alertes à 80 % puis 95 %.

Supervision

Métriques Prometheus, lues en local ou en HTTPS avec un jeton : version et mise à jour en attente, état du moteur de téléphonie, appels en cours, postes inscrits, trunks par état, licence, webhooks, adresses bannies, volumes, réplication. Alertes de référence fournies.

Alertes par e-mail

Trunk d'un client tombé puis rétabli, avec le motif du fournisseur ; licence ; stockage. Une alerte à chaque changement d'état, sans répétition à chaque tentative. Chaque revendeur règle les siennes.

Diagnostic sans SSH

Santé, appels en cours, trace de chaque appel, capture SIP en direct (texte, diagramme en échelle, pcap déchiffré pour Wireshark), rechargement de la configuration sans couper les appels, redémarrage du moteur de téléphonie qui attend la fin des appels.

Sécurité

Comptes

Mots de passe de 12 caractères au moins, compte bloqué 15 minutes après 5 échecs. Second facteur obligatoire pour vos équipes et vos revendeurs (application d'authentification et codes de secours), clés d'accès (passkeys).

Connexion unique

Depuis votre portail, par un jeton JWT signé, à usage unique et valable quelques minutes ; ou par un annuaire OpenID Connect : Microsoft Entra, Google Workspace, Keycloak.

Clés d'API

Rattachées à un rôle, jamais plus de droits que la personne qui les crée, avec une date d'expiration si vous voulez, révocables à tout moment. 300 requêtes d'affilée, puis 10 par seconde.

Secrets

Mots de passe des trunks et du serveur d'e-mails, secrets des webhooks et du second facteur chiffrés en base, jamais renvoyés par l'API. La clé de chiffrement se remplace par une commande.

Journal d'audit

Chaque action, chaque connexion et chaque refus, avec qui, quand et d'où. Le journal est chaîné : kanadr audit verifier vérifie qu'il n'a pas été altéré.

Bannissement

Après 10 échecs en 5 minutes, une adresse est bannie une heure, pour le SIP et la voix seulement : le portail reste joignable. Liste blanche ; les adresses des trunks et des téléphones inscrits sont épargnées.

Accès de l'éditeur

Fermé par défaut. Vous l'ouvrez pour 4 heures à 7 jours, il se referme seul, et chaque action de notre assistance figure au journal d'audit.

Isolation

Chaque version est testée pour qu'un client, un revendeur ou une clé d'API ne lise ni ne modifie rien hors de son périmètre.

Fabrication

Analyse statique (avertissements traités comme des erreurs), audit des dépendances (failles, licences, provenance), recherche de secrets dans tout l'historique, tests sur le vrai moteur de téléphonie à chaque modification, revue de sécurité écrite à chaque version majeure.

Signalement

Une faille signalée reçoit une réponse sous 3 jours ouvrés. Le correctif arrive par le dépôt apt, et vous êtes prévenus directement, avec la version qui corrige.

Intégrations

API

Tout ce que fait le portail passe par l'API, décrite en OpenAPI en français et en anglais : revendeurs, clients, numéros, grilles, trunks, diagnostic, réglages. Vos clients ont leur propre documentation, limitée à leurs opérations. Codes d'erreur stables.

Serveur MCP

Les mêmes opérations pour vos outils d'IA, avec les droits de la clé utilisée.

Webhooks

Signés par un secret. Pour vous : appels du mois écoulé, nouveau client, nouveau poste, trunk tombé ou rétabli. Pour vos clients : nouveau message vocal, appel enregistré. Désactivés après 20 échecs de suite, avec la cause affichée.

Transcription

Par n'importe quel service compatible avec l'API de transcription d'OpenAI : en ligne (OpenAI, Mistral) ou installé chez vous (Whisper). Chaque message est transcrit dans la langue de son client ; en cas de panne, l'e-mail part sans le texte.

Assistant IA

Avec votre clé d'API Claude et un budget mensuel par instance et par client ; au budget atteint, il se met en pause jusqu'au mois suivant. Il propose chaque modification avant de la faire et n'a pas accès à la sécurité des comptes.

Téléphones

Téléphones de bureau configurés à distance par des profils de matériel : Yealink de bureau (T31G à T87W) et DECT (base W70B), adaptateurs Grandstream HT802 et HT812. Un profil livré se duplique pour l'adapter à un autre modèle, et le RPS de Yealink configure un téléphone sorti du carton. Sur ordinateur, le téléphone dans le navigateur, à votre marque, installable (Chrome, Edge, Safari), ou l'application Windows et Mac. Sur mobile, l'application iPhone et Android à vos couleurs, configurée par un code QR.

Données et RGPD

Qui est responsable

Vous êtes responsable de traitement pour vos comptes et la facturation ; chaque client l'est pour ses collaborateurs, et vous êtes son sous-traitant. Installé chez vous, nous n'avons accès à aucune donnée ; hébergé par nous, les données restent en France et nous agissons comme votre sous-traitant (article 28). Fiche de traitement type fournie pour votre registre.

Durées de conservation

Enregistrements six mois au plus, journal des appels un an au moins (CPCE, article L34-1), messages vocaux sans limite par défaut. Réglables par l'opérateur et par client ; la purge passe chaque heure.

Droits des personnes

Export des données d'une personne en JSON, effacement de son compte, de sa messagerie et de ses enregistrements. Le journal d'audit reste, protégé contre toute modification.

Numéros masqués

Au journal des appels, les numéros externes peuvent être masqués en partie ; leur affichage complet est réservé à l'admin du client, et tracé.

Transferts

Aucun transfert hors de l'Union européenne par la plateforme elle-même. La transcription et l'assistant n'en font que si vous réglez un fournisseur qui en fait.

Licence

Le relevé quotidien ne compte que des utilisateurs par client, désignés par un identifiant : aucune donnée personnelle ne nous parvient.

$ sudo apt install kanadr
$ kanadr initialiser --operateur "Votre marque" --admin-courriel [email protected]
$ kanadr verifier
$ kanadr bascule preparer --ip-flottante 192.0.2.10/24 --autre 192.0.2.12

Questions techniques fréquentes

Sur quelle infrastructure s'installe Kanadr ?

Kanadr s'installe sur une VM Debian 13 dédiée à l'opérateur, qui accueille tous ses revendeurs et clients. L'image est fournie en qcow2 (KVM, Proxmox, OpenStack) ou en OVA (VMware, VirtualBox), ou en paquet Debian (apt install kanadr). La pile comprend PostgreSQL, nginx et le moteur de téléphonie de Kanadr, avec un cœur écrit en Rust. Il faut au moins 12 Go de disque et une adresse IP publique fixe.

Combien d'appels simultanés une VM Kanadr supporte-t-elle ?

Une VM Kanadr de 2 vCPU et 4 Go tient 200 appels simultanés, soit 1 300 à 2 000 postes en usage de bureau ; une VM de 1 vCPU et 2 Go en tient 100. La qualité mesurée reste à un MOS de 4,48 tant que le processeur ne sature pas, et se dégrade au-delà de 250 appels sur 2 vCPU. C'est le nombre d'appels simultanés, pas le nombre de clients, qui dimensionne la machine.

Comment fonctionne la haute disponibilité de Kanadr ?

Kanadr fait fonctionner deux VM en actif/passif derrière une IP flottante. La base est répliquée en continu, avec quelques secondes de retard au plus, et les fichiers sont copiés chaque minute. Après 3 secondes de silence de l'active, la passive prend la main : le service revient en moins de deux minutes, sans réenregistrement des téléphones. Les appels en cours sont perdus.

Quels téléphones fonctionnent avec Kanadr ?

Kanadr configure à distance les téléphones de bureau Yealink (T31G à T87W), la base DECT Yealink W70B et les adaptateurs Grandstream HT802 et HT812 ; avec le RPS de Yealink, un téléphone se configure en sortant du carton. S'y ajoutent un téléphone dans le navigateur (Chrome, Edge, Safari), une application Windows et Mac, et une application iPhone et Android à la marque de l'opérateur.

Les appels passés avec Kanadr sont-ils chiffrés ?

Oui. Avec Kanadr, le téléphone dans le navigateur est toujours chiffré. Pour les softphones SIP, le SIP en TLS 1.2 ou 1.3 et la voix en SRTP s'activent en un réglage. Les liaisons vers des services tiers (connecteurs SIP) sortent en TLS, sans port à ouvrir en entrée.

Où sont stockées les données, et qui en est responsable au sens du RGPD ?

Installé chez l'opérateur, Kanadr n'a accès à aucune donnée. Hébergé par Kanadr, les données restent en France et Kanadr agit comme sous-traitant de l'opérateur (article 28 du RGPD). La plateforme ne transfère aucune donnée hors de l'Union européenne ; la transcription et l'assistant ne le font que si l'opérateur choisit un fournisseur qui le fait. Les enregistrements sont conservés six mois au plus.

Dernière mise à jour : 31 octobre 2026