Installer

Le serveur Meshloom est conçu pour Linux. Une machine qui reste allumée fait un bien meilleur hôte qu’un portable qu’on referme : tant que le serveur tourne, il écoute le mesh et écrit ce qu’il entend.

Un script d’installation fait le travail et pose des questions, en français ou en anglais. À coller dans un terminal :

/bin/bash -c "$(curl -fsSL https://get.meshloom.app)"

Pourquoi /bin/bash -c

Cette forme n’est pas décorative. Le script est interactif : il demande la langue, le mode d’installation, le dossier d’installation pour Docker et, si plusieurs ports série sont branchés, lequel mapper. Avec /bin/bash -c "$(...)", le téléchargement se termine d’abord, puis le script s’exécute avec le terminal disponible pour ses questions.

Si on l’envoie dans un tube — curl … | bash — l’entrée du script est occupée par le téléchargement. Les questions n’ont plus de terminal pour s’afficher et l’installation part de travers. Gardez le /bin/bash -c.

Ce que le script demande

Les questions, dans cet ordre.

Le mode. Un service natif géré par systemd, ou Docker. Le service natif démarre automatiquement avec la machine et sait parler à une radio USB, réseau ou Bluetooth. Docker fonctionne dans un conteneur, ce qui isole l’installation mais restreint l’accès au matériel : partager une radio USB avec un conteneur suppose un Docker en mode root sur Linux. Si ce n’est pas le cas, le script le dit et propose la radio réseau.

La radio. Le transport se configure dans l’interface après l’installation, pas par variable d’environnement. Une installation systemd native ne demande ni port série, ni hôte TCP, ni PIN BLE. Docker peut encore demander USB ou réseau, uniquement pour émettre un mapping Compose devices: pour une radio USB.

Les détails de chaque transport sont dans Transports radio.

La sécurité. Le script ne pose aucune question de sécurité. Les bots exécutent du code sur la machine et sont activés par défaut ; seul le paquet Linux les coupe, dans /etc/meshloom/meshloom.env. Ailleurs, MESHCORE_DISABLE_BOTS=true les désactive, et MESHCORE_BASIC_AUTH_USERNAME / MESHCORE_BASIC_AUTH_PASSWORD imposent un accès partagé. Voir Un réseau de confiance.

Un récapitulatif s’affiche avant de lancer quoi que ce soit. Certaines étapes demandent les droits administrateur.

Ouvrir l’interface

Une fois l’installation terminée, depuis la machine elle-même :

http://127.0.0.1:8000

Depuis un autre appareil du même réseau, remplacez 127.0.0.1 par l’adresse IP de la machine, en gardant le port 8000.

Le transport radio se configure ensuite dans l’interface : Premier lancement.

Attention à ne pas confondre deux adresses proches. http://127.0.0.1:8000/docs est la documentation technique de l’API que le serveur génère lui-même. Ce n’est pas cette documentation-ci.

Pour vérifier ou redémarrer un service natif :

sudo systemctl status meshloom

Mettre à jour

Quand les mises à jour depuis l’interface sont disponibles, Réglages → Mises à jour installe la nouvelle version de Meshloom. Les mises à jour automatiques restent éteintes tant que vous ne les activez pas. Ce chemin ne met à jour que Meshloom et ne lance jamais un apt upgrade du système.

Les mises à jour sont signées. L’installeur embarque la clé de publication Meshloom et vérifie son empreinte ; il ne la télécharge jamais et n’ajoute jamais de source de paquets non signée. Le paquet Linux vérifie la signature du dépôt, et l’assistant de mise à jour refuse de tourner si la source Meshloom n’est pas vérifiée. Avec Docker, l’image est épinglée par empreinte dans le .env voisin de docker-compose.yml (MESHLOOM_IMAGE=…@sha256:…), et l’assistant ne déplace cet épinglage que vers une version plus récente dont l’empreinte est signée. Il ne revient jamais en arrière.

Si Réglages → Mises à jour indique une mise à jour manuelle, ou demande de relancer l’installeur, relancez-le : il garde vos données, remplace un ancien assistant de mise à jour et, pour Docker, conserve le Compose précédent en docker-compose.yml.bak-<date>. Si vous avez modifié votre docker-compose.yml (un port ajouté, par exemple), l’installeur vous montre vos modifications et propose de les garder, ce qui est le choix par défaut : il ne met alors à jour que ses propres lignes (image, assistant de mise à jour) et laisse les vôtres. S’il ne sait pas adapter votre fichier, il n’y touche pas et vous demande s’il faut le régénérer. Lancez l’installeur avec le même compte que celui qui a créé la pile : root si elle est dans /root/meshloom. À la main :

sudo apt-get install --only-upgrade meshloom   # Debian / Ubuntu
sudo dnf install meshloom                      # Fedora
sudo docker compose pull && sudo docker compose up -d   # Docker sans l’assistant

La base de données reste en place : /var/lib/meshloom pour le paquet, ./data pour Docker. Les migrations de schéma s’exécutent au démarrage.

Un Raspberry Pi peut aussi partir de l’image préinstallée au lieu de ce one-liner.

Sur Home Assistant

Si Home Assistant tourne déjà sur la machine qui hébergera Meshloom, installez-le plutôt comme add-on. L’interface arrive dans la barre latérale, la base est conservée avec le reste des données de Home Assistant, et Meshloom démarre et s’arrête avec lui.

Le bouton ouvre la fenêtre sur votre propre instance avec l’adresse déjà remplie ; c’est un redirecteur, il n’apprend rien sur vous. À la main, l’adresse se saisit dans Paramètres → Modules complémentaires → Boutique → ⋮ → Dépôts, puis on installe Meshloom.

Deux choses s’y passent différemment :

Le port du proxy radio se règle dans Home Assistant, pas dans Meshloom. L’interface passe par la barre latérale et ne publie rien : le proxy est la seule chose présente sur le réseau. Son port se change dans le panneau Réseau de l’add-on ; le champ dans Meshloom l’affiche et le dit, parce qu’une valeur saisie là laisserait le proxy à l’écoute là où rien n’est redirigé.

Les notifications ont besoin d’une adresse à elles. La barre latérale n’a pas d’adresse publique durable, donc Web Push ne peut pas fonctionner par ce seul chemin. Donner un vrai nom d’hôte à l’instance — l’add-on Cloudflared le fait sans ouvrir de port sur votre box — et ouvrir Meshloom à cette adresse est ce qui rend les notifications possibles. L’option public_url de l’add-on est transmise à Meshloom mais reste sans effet pour l’instant.

Ce n’est pas la même chose que publier le mesh vers Home Assistant en MQTT, qui fonctionne depuis n’importe quelle installation et ne demande aucun add-on.

Les autres chemins

Le script couvre le cas courant. Le reste — image Docker ghcr.io/twinrocket/meshloom, Portainer, HTTPS, systemd à la main, variables d’environnement, ou un dépôt cloné pour développer — est dans Autres chemins d’installation.

Ensuite : Premier lancement.