Installation

Une seule commande, sur une machine Linux neuve. Ensuite, tout se règle dans le navigateur.

Ce qu'il faut

Élément	Minimum	Conseillé
Système	Ubuntu 24.04 ou Debian 12, installation neuve (64 bits)
Mémoire	1 Go (un PBX)	2 Go pour un PBX, 4 Go et plus en multi-tenant
Disque	3 Go libres	20 Go et plus si vous gardez les enregistrements d'appels
Accès	Un accès « root » (PuTTY sur Windows, ou le terminal de l'hébergeur)
Licence	Une licence Callikoe (l'essai gratuit de 30 jours en est une), commandée sur le portail pro

Le logiciel est envoyé par le portail Callikoe uniquement aux serveurs qui ont une licence valide : la commande d'installation contient cette preuve.

Un PBX ou plusieurs ?

PBX seul

Une machine = un standard. C'est le choix naturel pour un serveur posé chez le client, ou une machine virtuelle sur son hyperviseur. La console est sur le port 8822 de la machine.

Serveur multi-tenant

Une machine = plusieurs PBX clients, chacun isolé : son moteur téléphonique, sa base de données, sa console, son adresse (client.callikoe.fr ou votre domaine) et son trunk. Aucun PBX ne voit les autres. Tous sont joignables en SIP sur le port 5060. C'est le mode des partenaires : un VPS suffit pour démarrer, on l'agrandit avec le nombre de clients.

La console du serveur affiche ses ressources (processeur, mémoire, disques, place prise par chaque PBX) pour savoir quand l'agrandir.

Serveur local

Un PC de bureau récent ou un mini-serveur suffit pour un PBX. Installez Ubuntu Server 24.04 ou Debian 12 (sans interface graphique), branchez-le en filaire sur le réseau du client, donnez-lui une adresse IP fixe dans la box ou le routeur.

Derrière une box, il faut rediriger les ports listés plus bas vers le serveur et désactiver le « SIP ALG » de la box : c'est la première cause d'appels sans son ou de postes qui se décrochent.

Machine virtuelle

Proxmox, VMware ESXi, Hyper-V : créez une VM Ubuntu 24.04 ou Debian 12, 2 processeurs virtuels, 2 Go de mémoire, 20 Go de disque, carte réseau en mode « pont » (bridge) pour qu'elle ait sa propre adresse sur le réseau. Les mêmes règles de ports s'appliquent.

Windows avec WSL2 fonctionne aussi pour un test, mais pour un client en production, préférez une vraie VM ou une machine dédiée.

VPS

Chez OVHcloud, Hetzner, Scaleway ou tout autre hébergeur : commandez un VPS avec Ubuntu 24.04 ou Debian 12. L'hébergeur vous donne l'adresse IP et le mot de passe root par e-mail. Connectez-vous avec PuTTY (port 22), collez la commande, c'est tout.

Un VPS a une adresse publique : pas de redirection de ports à faire. Callikoe active lui-même le pare-feu et la protection anti-intrusion.

La commande

Copiez-la depuis le portail pro, elle y est déjà complétée :

PBX seul

Portail pro › Mes licences › menu de la licence › « Copier la commande d'installation (PBX seul) » :

curl -fsSL https://portail.callikoe.fr/dist/install.sh | sudo bash -s -- --cle PBXM-XXXX-XXXX-XXXX-XXXX

Serveur multi-tenant

Portail pro › Mes serveurs › « Nouveau serveur » : le portail crée l'adresse du serveur et sa configuration signée, puis affiche la commande à coller (elle commence par la même ligne, suivie de --multi-tenant --serveur …).

L'installation affiche ses étapes en français (système, moteur téléphonique, base de données, console, réseau, sécurité). À la fin, elle donne l'adresse de la console.

Ports et réseau

Usage	Ports	Remarque
Signalisation SIP	UDP 5060, TCP 5060-5061	Postes, softphone, appli, opérateur
Audio (RTP)	UDP 10000-20000 (PBX seul) UDP 10000-59999 (multi-tenant)	200 ports par PBX client en multi-tenant
Console et provisioning	TCP 80, 443, 8822	Certificat HTTPS automatique
Administration	TCP 22	SSH, pour l'installation

Tout le reste est bloqué par le pare-feu. Par défaut, la téléphonie n'est acceptée que depuis les pays autorisés (France au départ), réglables dans la console.

Après l'installation

Ouvrez l'adresse donnée à la fin (par exemple https://client.callikoe.fr:8822). La première connexion crée le compte administrateur avec double authentification. Le tableau de bord indique ensuite ce qui reste à faire : trunk, utilisateurs, routage. Suivez le parcours guidé.

Mises à jour

Le serveur regarde chaque matin s'il existe une nouvelle version et l'affiche dans Administration › Mises à jour, avec la liste des nouveautés. Rien ne s'installe sans votre accord : vous lancez la mise à jour tout de suite ou vous la programmez la nuit. Les mises à jour des téléphones (firmwares) se programment aussi, poste par poste ou par lot.