Sommaire
- Premiers pas
- Installation
- Première configuration et association des apps
- Lignes et lecteurs de cartes
- Messages et appels
- Routage
- eSIM
- Liste de compatibilité
- Sorties réseau et moteurs de proxy
- Point d’accès et Wi-Fi
- Contrôle à distance par bot Telegram
- Voyant d’état (LED)
- Mises à jour et sauvegardes
- Dépannage
- Utilisateurs au Royaume-Uni
- Comparaison avec d’autres outils
Documentation / 02
Installation
Il existe des programmes d’installation pour Windows, macOS et Linux. Le même programme fait une nouvelle installation ou une mise à niveau depuis 1.x. Si une étape échoue, il remet tout en place.
Choisir le programme d’installation
Téléchargez le programme d’installation là où vous avez obtenu Cevix, ou demandez-le à votre revendeur. Choisissez le fichier pour votre système et votre processeur : un PC classique ou un Mac Intel, c’est amd64 ; un Mac Apple silicon, un Raspberry Pi, une carte Armbian ou la clé 410, c’est arm64.
| Système | Programme d’installation |
|---|---|
| Windows | CevixSetup-…-windows-….exe |
| macOS | Cevix-…-macos-….pkg |
| Debian, Ubuntu, Raspberry Pi OS, Armbian | cevix-gateway_…_….deb |
| Autres Linux | cevix-setup-…-linux-… |
Une fois l’installation faite, ouvrez https://<adresse de cette machine>:8443 dans un navigateur. Sur la même machine, c’est https://localhost:8443. La première fois, le navigateur affiche un avertissement de certificat ; vérifiez qu’il s’agit bien de votre machine et continuez. Voir ensuite Première configuration.
Windows
- Double-cliquez sur le programme d’installation et choisissez « Oui » dans le Contrôle de compte d’utilisateur.
- Acceptez la licence avec “I Agree”.
- Sur la page “Product key”, collez votre clé, ou cochez “Enter it later on the web page”.
- À la fin, vous pouvez cocher “Open the Cevix web interface”.
Par la suite, ouvrez l’interface web depuis le dossier Cevix Gateway du menu Démarrer. Pour la supprimer, désinstallez Cevix Gateway dans Paramètres Windows → Applications.
SmartScreen et antivirus
Le programme d’installation n’a pas de signature de code, Windows affiche donc « Windows a protégé votre ordinateur ». Choisissez « Informations complémentaires » → « Exécuter quand même ».
Certains antivirus affichent un avertissement de réputation. Choisissez de faire confiance au programme, ou ajoutez C:\Program Files\CevixGateway et C:\ProgramData\CevixGateway aux exceptions. Si l’installation a été bloquée en cours de route, ajoutez les exceptions et relancez le programme d’installation.
Si le Pare-feu Windows bloque le port 8443, ajoutez une règle vous-même.
macOS
Le programme d’installation n’est ni signé ni notarié par Apple, donc la première fois macOS indique qu’il provient « d’un développeur non identifié » :
- macOS 14 et versions antérieures : dans le Finder, faites un clic droit sur le fichier → Ouvrir → Ouvrir.
- macOS 15 et versions ultérieures : double-cliquez une fois et fermez l’avertissement. Dans Réglages Système → Confidentialité et sécurité, faites défiler vers le bas et choisissez « Ouvrir quand même », puis saisissez votre mot de passe.
Choisissez ensuite Installer et saisissez votre mot de passe. Une fois l’installation terminée, le navigateur ouvre l’interface web.
Linux
Paquet Debian (recommandé)
Pour Debian 12 ou ultérieur, Ubuntu 22.04 ou ultérieur, Raspberry Pi OS et Armbian :
sudo apt install ./cevix-gateway_<version>_<processeur>.deb
Gardez le ./ au début. L’installation demande la clé produit ; laissez-la vide pour la saisir plus tard sur la page web.
sudo apt remove cevix-gateway: supprime le programme et conserve vos données.sudo apt purge cevix-gateway: supprime aussi vos données. C’est irréversible.
Autres Linux
chmod +x cevix-setup-<version>-linux-<processeur>
sudo ./cevix-setup-<version>-linux-<processeur>
Clé 410 et petites cartes
- Utilisez le fichier arm64.
- N’ajoutez pas de swap : cela use la mémoire de stockage intégrée.
- Conservez le Wi-Fi et ModemManager.
- La mémoire est réduite : ne faites pas tourner beaucoup de sorties proxy à la fois ; voir Sorties réseau.
Connectez-vous juste après l’installation
Tant que vous n’avez pas créé l’administrateur, toute personne qui peut joindre cette machine peut en créer un. Terminez tout de suite la Première configuration.
Mise à niveau depuis 1.x
Pour passer de 1.x à 2.0, utilisez le programme d’installation. N’envoyez pas le paquet de mise à jour 2.0 depuis la page web de 1.x : elle indique que la signature ne correspond pas.
- Il faut la version 1.3.6 ou ultérieure. Sur une version plus ancienne, mettez d’abord à jour vers 1.3.6 dans 1.x.
- Votre compte administrateur, vos lignes, vos paramètres, vos SMS, votre historique d’appels et votre autorisation sont repris. Les applications mobiles n’ont pas besoin d’être associées à nouveau.
- Les lignes sont hors ligne pendant un moment au cours de la mise à niveau. Prévoyez 15 minutes. Faites d’abord une sauvegarde.
- Si la mise à niveau échoue, le programme d’installation remet l’ancienne version.
Une fois en 2.0, les mises à jour suivantes se font dans l’interface web ; voir Mises à jour et sauvegardes.
Commandes utiles
Dans un terminal Linux ou macOS, ou dans une invite de commandes Windows exécutée en tant qu’administrateur :
cevix status # version, services, adresse
cevix open # ouvrir l’interface web dans un navigateur
sudo cevix restart # redémarrer (aussi start, stop)
sudo cevix update apply # installer la dernière mise à jour officielle