Installer Elyxie

Ce chapitre s'adresse à la personne qui installe la box Elyxie : la machine, le serveur de messages MQTT, la passerelle Zigbee facultative, puis l'ouverture de la console sur une tablette.

01À quoi ça sert

La box Elyxie est une petite machine du réseau local qui fait tourner l'application et garde toute la configuration. Les tablettes, téléphones et ordinateurs de la maison l'ouvrent dans leur navigateur : ils n'ont besoin de joindre qu'elle.

Ce qu'il faut prévoir

• Une machine sous Debian 13, processeur 64 bits (mini-PC ou Raspberry Pi 4 ou 5), allumée en permanence.
• De la mémoire et du disque : 1 Go de mémoire au minimum, 2 Go conseillés ; comptez 4 Go de disque libre au moment d'une mise à jour, car la box reconstruit son application.
• Docker, installé selon la procédure officielle de Docker pour Debian.
• Un serveur de messages MQTT sur une autre machine du réseau (Mosquitto, par exemple). Elyxie ne l'installe pas : elle s'y raccorde.
• Une antenne Zigbee réseau, si vous voulez des appareils Zigbee sans Jeedom. La passerelle d'Elyxie la joint par le réseau : rien à brancher sur la box.
• Une adresse fixe pour la box : réservez-lui une adresse dans votre box internet (bail DHCP réservé), pour que les tablettes la retrouvent toujours.

02Pas à pas

Installer et démarrer la box

1. Installez Debian 13 à jour, puis Docker.

2. Récupérez le projet Elyxie sur la machine (votre fournisseur vous en donne l'accès).

3. Placez-vous dans le dossier « docker » du projet, puis construisez et démarrez l'application :

   docker compose up -d --build
   

4. La première construction prend plusieurs minutes, davantage sur un Raspberry Pi.

5. Une fois démarrée, Elyxie répond sur le port 80 de la machine, et redémarre seule après une coupure de courant.

Le port 80 doit être libre : si un autre serveur web tourne déjà sur la machine, arrêtez-le d'abord, sinon l'application refuse de démarrer. Pour utiliser un autre port, l'installateur l'indique dans le fichier de réglages de la box, dans le même dossier, plutôt que de modifier les fichiers du projet : ce fichier n'est jamais touché par les mises à jour.

Raccorder le serveur MQTT

Sur la machine du serveur MQTT, créez un utilisateur dédié à Elyxie, avec un mot de passe, et laissez le serveur conserver ses messages quand il redémarre (c'est le réglage par défaut de Mosquitto sous Debian).

Le raccordement se fait ensuite depuis l'administration d'Elyxie, une fois le code d'administration créé : « Réglages généraux », carte « Broker MQTT ».

1. Choisissez l'« Espace » à raccorder.
2. Choisissez le « Protocole » : « TCP (mqtt) — broker sur le réseau » pour un serveur Mosquitto, sur le port 1883 (laissé vide, le port suit le protocole).
3. Saisissez l'« Hôte » (l'adresse du serveur, par exemple 192.168.1.20), le « Nom d'utilisateur » et le « Mot de passe ».
4. Enregistrez, puis touchez « Tester la connexion ».

La connexion part de la box, pas de la tablette : c'est la box qui doit pouvoir joindre le serveur MQTT.

Mettre en service la passerelle Zigbee (facultatif)

Elyxie démarre avec sa propre passerelle Zigbee, endormie tant qu'elle n'est pas configurée. Sa mise en service se fait depuis l'administration, écran « Zigbee », onglet « Passerelle », en trois étapes : le serveur MQTT, l'antenne, puis le réseau Zigbee.

• Une seule passerelle par antenne. Si une autre passerelle Zigbee utilisait déjà l'antenne, arrêtez-la avant : l'administration refuse de démarrer la sienne tant que l'ancienne répond.
• La passerelle publie une interface de diagnostic sur le port 8080 de la box, protégée par un jeton affiché dans l'administration.

Ouvrir la console sur une tablette

1. Raccordez la tablette au WiFi de la maison.
2. Ouvrez le navigateur et saisissez l'adresse de la box, par exemple « http://192.168.1.50 (s'ouvre dans un nouvel onglet) ».
3. La console s'affiche. Sur une installation neuve, elle invite d'abord à ouvrir l'administration : voir Premier démarrage et code d'administration.
4. Ajoutez la page à l'écran d'accueil de la tablette, pour l'ouvrir d'un toucher.

Ouvrir l'administration

• Depuis n'importe quel appareil de la maison, ajoutez « #/admin » à l'adresse : par exemple « http://192.168.1.50/#/admin (s'ouvre dans un nouvel onglet) ». Le signe « # » est indispensable.
• Ou, sur un espace où l'administrateur l'a autorisé, touchez le bouton d'administration (un bouclier) en haut à droite de la console.

L'écran du code propose « Quitter » pour revenir à la console sans se connecter.

Préparer une tablette murale

Une tablette fixée au mur affiche la console en continu. Quelques réglages de la tablette elle-même l'y aident :

• empêchez la mise en veille de l'écran dans les réglages de la tablette : Elyxie a son propre écran de veille, qui affiche l'horloge ;
• laissez-la sur le secteur ;
• affichez la console en plein écran, depuis le raccourci de l'écran d'accueil.

L'application mobile Elyxie, lorsqu'elle vous est fournie, propose aussi un mode kiosque : plein écran, barres du système masquées et réglages de l'application protégés par un code. Une tablette en mode kiosque ne reçoit pas de notifications.

Penser à la sauvegarde

Toute la configuration (espaces, pages, appareils, code d'administration, historique) vit dans un espace de données de la box, distinct de l'application. L'application se reconstruit sans conséquence ; perdre cet espace de données, c'est perdre l'installation. Faites-en une copie dès que la configuration est en place, puis régulièrement. La passerelle Zigbee a son propre espace de données, qui porte la clé du réseau Zigbee : sauvegardez-le aussi.

03Astuces

• Testez d'abord depuis un ordinateur. L'adresse de la box saisie dans un navigateur d'ordinateur montre tout de suite si l'application répond, avant de régler les tablettes.
• Notez l'adresse de la box sur une étiquette collée sous la machine : c'est la première chose qu'on vous demandera en cas de souci.
• Le micro et la caméra demandent une connexion sécurisée. Pour l'interphone, la console doit être servie en HTTPS, avec un certificat : c'est un réglage de l'administration, à prévoir dès l'installation si vous avez un portier.

04Limitations

• Elyxie n'installe pas le serveur MQTT : il vit sur une autre machine du réseau, et doit rester joignable depuis la box.
• Le bouton « Mettre à jour » de l'administration demande un service installé sur la machine par l'installateur. Sans lui, la demande de mise à jour est enregistrée et rien ne se passe : c'est le comportement prévu.
• La console est servie en HTTP simple tant que le certificat n'est pas activé : le micro, donc l'interphone, ne fonctionne pas sans HTTPS.
• La passerelle d'Elyxie est prévue pour une antenne réseau, joignable depuis la box : une antenne branchée en USB demande une adaptation de l'installation, à voir avec votre installateur.
• Précaution d'usage — les sauvegardes sont sensibles. Une copie de l'espace de données contient les mots de passe en clair (serveur MQTT, Jeedom, services raccordés) et, pour la passerelle, la clé du réseau Zigbee. Rangez-la en lieu sûr et ne la transmettez jamais.

05Voir aussi

• Découvrir Elyxie : ce que fait la console.
• Premier démarrage et code d'administration : la suite, une fois la box démarrée.
• Les espaces et les tablettes : attribuer chaque tablette à son espace.