Briques techniques

gtbapexpress

Open Apexpress

Déployer des conteneurs sur un ECLYPSE APEX en quelques clics — Mosquitto, Zigbee2MQTT, Node-RED, ChirpStack, InfluxDB, Grafana… Exécutable Windows + mode démo.

eclypse apex
docker
mqtt
node-red
chirpstack

$ télécharger code source

pas d'APEX sous la main ? l'exécutable a un mode démo avec un APEX simulé.

Tes conteneurs sur ECLYPSE APEX, en express. L'APEX de Distech Controls fait tourner des conteneurs Docker. Mais entre les règles du plugin OPA, les images ARM64, l'absence de SSH et les JSON à écrire à la main, monter un Mosquitto + Zigbee2MQTT + Node-RED prend vite une après-midi.

Open Apexpress fait tout ça en quelques clics, uniquement par l'API REST v2 officielle de l'APEX. Pas d'installation, pas de dépendance : un .exe autonome à passer à un collègue sur une clé USB.

Catalogue Open Apexpress : packs prêts à l’emploi et services à cocher, avec leur statut et leur port — choix des services, ici le pack Zigbee + Grafana (mode démo)

§ 01 Ce que ça fait

Installation: Tu coches les services ou tu prends un pack (Zigbee, LoRaWAN, Courbes, Maintenance). Images, création et démarrage dans le bon ordre, suivi en direct, puis liens, identifiants et rapport.
Catalogue: Mosquitto, Zigbee2MQTT, ChirpStack, Node-RED, InfluxDB, Telegraf, Grafana, Cloudflare Tunnel, Tailscale, FileBrowser, ntfy, Uptime Kuma, MQTT Web, Netdata, Nginx Proxy Manager, un portail de liens… Images ARM64 vérifiées, tags fixés.
Sur l'APEX: Conteneurs (état, ports cliquables, démarrer, arrêter, redémarrer, supprimer) et volumes, avec suppression protégée.
Sauvegardes: Un volume en .tar.gz sur ton PC, sans SSH, et restauration dans un volume existant ou neuf : de quoi copier un APEX vers un autre.
Mises à jour: Comparaison de chaque image avec Docker Hub, nouvelle image téléchargée avant de toucher au service, conteneur recréé avec sa configuration et ses volumes.
Outils: Tester si une image tourne en ARM64, déployer un conteneur personnalisé vérifié contre les règles de l'OPA, journal de toutes les requêtes envoyées à l'APEX.
MCP ECLYPSE: Un serveur MCP qui donne à Claude l'accès aux points BACnet, trend logs, programmes horaires et alarmes de l'APEX. Lecture seule par défaut, écriture encadrée en option.

Fin d'installation : chaque service vérifié, puis les liens et les consignes de chaque service — installation terminée : liens, identifiants et consignes par service

§ 02 Démarrage en 1 minute

Télécharge OpenApexpress-x.y.z-windows-x64.exe dans les releases GitHub.
Lance-le : une console s'ouvre (laisse-la ouverte) et l'interface apparaît dans ton navigateur.
Entre l'IP de l'APEX, son identifiant et son mot de passe, ou clique sur Essayer sans APEX (mode démo).

Le fichier n'est pas signé numériquement : au premier lancement, « Windows a protégé votre ordinateur » → Informations complémentaires → Exécuter quand même.

Il faut un accès Internet côté APEX pour télécharger les images.

§ 03 Les règles de l'OPA, appliquées pour toi

Le plugin d'autorisation OPA de l'APEX refuse beaucoup de choses. Chaque conteneur généré respecte ce qui a été constaté sur le terrain :

ports hôtes dans la plage 50000-50500 ;
chaque port publié déclaré dans ExposedPorts ;
volumes nommés via Mounts, jamais de Binds ;
un seul cœur pour les conteneurs ("CpusetCpus": "0"), la régulation garde les autres ;
noms de conteneurs en minuscules, images ARM64 à tag fixe ;
pas de conteneur privilégié, de périphérique ni de réseau host.

§ 04 Sécurité

L'interface n'écoute que sur ta machine (127.0.0.1) et exige un jeton généré à chaque lancement : aucun autre poste ni site web ne peut piloter l'APEX à travers l'outil.
Les identifiants de l'APEX restent en mémoire, ne sont jamais écrits sur disque et ne sont envoyés qu'à l'APEX.
Les mots de passe générés n'apparaissent que dans l'écran final et le rapport : range ce rapport en lieu sûr.
Le serveur MCP est en lecture seule par défaut. Avec l'écriture activée, il simule d'abord, n'écrit qu'après confirmation, à une priorité BACnet dédiée, et journalise chaque écriture.

Les réponses de l'API de conteneurisation ne sont pas documentées par Distech. La toute première utilisation sur un APEX réel se fait avec un œil sur l'onglet Journal. Les services marqués « À tester » sont à essayer sur site avant de compter dessus.

§ 05 Ce qui est fourni, service par service

17 services dans le catalogue, tous des images ARM64 vérifiées avec des tags fixés. À quoi sert chacun, et pourquoi c'est pratique :

🔌 Le bus de messages

Mosquitto validé sur APEX Le broker MQTT : le carrefour par où passent tous les messages entre capteurs, Node-RED et le reste. Le plus : l'authentification en option se propage toute seule aux autres services.
MQTT Web à tester Un client MQTT dans le navigateur pour voir passer les messages et en publier à la main. Le plus : déboguer sans rien installer sur ton PC.

📡 Les capteurs sans fil

Zigbee2MQTT validé sur APEX La passerelle qui transforme les capteurs Zigbee en messages MQTT, via un coordinateur Ethernet (SLZB-06…). Le plus : tes capteurs Zigbee tournent dans l'armoire, sans cloud constructeur.
ChirpStack validé sur APEX Un serveur LoRaWAN complet (PostgreSQL, Redis, Gateway Bridge, API REST). Le plus : ton propre réseau LoRaWAN sur l'APEX, sans image personnalisée à builder grâce à un petit conteneur d'initialisation.

🧠 Le lien avec la GTB

Node-RED validé sur APEX Les flows qui relient MQTT à l'API REST de l'APEX et donc aux points BACnet. Le plus : c'est le pont qui fait d'un message MQTT un point que la GTB sait lire ; mot de passe et modules préinstallés en option.
MCP ECLYPSE à tester Un serveur MCP qui donne à Claude la lecture des points BACnet, trend logs, programmes horaires et alarmes. Le plus : tu poses une question à ton installation en langage naturel ; lecture seule par défaut, écriture encadrée en option.

📈 Historique et courbes

InfluxDB validé sur APEX La base de séries temporelles qui garde l'historique des mesures. Le plus : la durée de rétention est réglable, pour ne pas saturer le stockage de l'APEX.
Telegraf validé sur APEX Le collecteur qui envoie les messages MQTT (Zigbee, LoRaWAN, sujets libres) vers InfluxDB. Le plus : sa configuration est générée, rien à écrire à la main.
Grafana validé sur APEX Les tableaux de bord pour visualiser les courbes. Le plus : la source InfluxDB est créée automatiquement, tu ouvres et tu vois tes mesures.

🔐 Accès distant et sécurité

Cloudflare Tunnel validé sur APEX Un accès distant sans ouvrir de port. Le plus : ça marche même quand l'APEX est derrière un modem 4G.
Tailscale validé sur APEX Un VPN maillé en mode userspace, avec l'APEX annoncé comme route. Le plus : tu rejoins l'APEX depuis l'extérieur, sans configurer de VPN à la main.
Nginx Proxy Manager à tester Un proxy inverse avec gestion des certificats. Le plus : tes services répondent sous un nom propre plutôt qu'en IP:port.

🚨 Supervision et alertes

ntfy à tester Des notifications push sur smartphone, sans cloud. Le plus : une alarme arrive sur ton téléphone sans service tiers.
Uptime Kuma à tester La supervision des équipements du site (ping, HTTP, ports). Le plus : tu sais qu'un équipement est tombé avant que le client t'appelle.
Netdata à tester CPU, RAM et disque de l'APEX en temps réel. Le plus : tu vois si l'APEX souffre avant d'y ajouter un conteneur de plus.

🛠️ Dépannage et confort

FileBrowser validé sur APEX Un explorateur de fichiers pour lire les logs et éditer les configs d'un volume. Le plus : tu dépannes sans SSH, ce que l'APEX n'offre pas.
Portail APEX validé sur APEX Une page d'accueil avec les liens de tous les services installés. Le plus : un seul point d'entrée à donner au client.

« Validé sur APEX » : recette utilisée sur un APEX réel. « À tester » : image ARM64 vérifiée, mais pas encore validée sur un APEX réel avec Open Apexpress.

Licence MIT. Projet indépendant, non affilié à Distech Controls. ECLYPSE est une marque de Distech Controls. github.com/OpenGTB/open-apexpress