La solution source reste exceptionnellement actuelle. Un membre de la communauté a indiqué directement les instructions Linux officielles de Homey et utilisé un conteneur Docker avec le réseau de l’hôte, le mode privilégié, le redémarrage automatique et un chemin ~/.homey-shs de répertoire ponctuelle. L’auteur de la publication d’origine a répondu que l’installation fonctionnait.
Les pages d’assistance officielles actuelles de Homey utilisent toujours la même architecture de conteneur et fournissent désormais aussi un exemple Docker Compose. Sur ZimaOS, Compose est généralement plus facile à documenter et à reproduire qu’une commande docker run commande.
Vérifier la configuration minimale actuelle requise par Homey
Le serveur auto-hébergé Homey nécessite actuellement :
- un processeur Intel/AMD ou Arm 64 bits ;
- au moins 1 Go de mémoire vive disponible ;
- au moins 1 Go de stockage disponible ;
- une adresse IP ou un chemin LAN dédié accessible aux clients.
ZimaOS fournit déjà Docker ; n’exécutez donc pas le script générique d’installation de Docker de Homey sur l’hôte.
La solution source utilise l’architecture Docker Run officielle de Homey
La commande source utilisée était :
-
--network host; -
--privileged; -
--restart unless-stopped; - un dossier persistant de l’hôte associé à
/homey/user/; -
ghcr.io/athombv/homey-shs.
L’auteur de la publication d’origine a confirmé que le serveur s’était installé et fonctionnait.
La documentation actuelle de Homey fournit également Docker Compose
L’exemple Compose maintenu par Homey utilise la même conception :
services:
homey-shs:
image: ghcr.io/athombv/homey-shs:latest
container_name: homey-shs
restart: unless-stopped
network_mode: host
privileged: true
volumes:
- ~/.homey-shs:/homey/userVoir le flux de travail Compose actuel de Homey pour le serveur auto-hébergé.
Utiliser un chemin persistant explicite sur ZimaOS
La documentation en amont ~/.homey-shs ce chemin est valide dans un shell Linux classique, mais sur ZimaOS, il est plus propre de choisir un emplacement de stockage accessible en écriture, tel qu’un dossier AppData dédié dans l’espace de stockage que vous sauvegardez réellement.
Associez ce dossier de l’hôte à /homey/user et documentez-la avant de procéder à de futures réinstallations.
La mise en réseau de l’hôte est intentionnelle
La configuration Compose officielle de Homey utilise network_mode: host, ce qui donne au conteneur un accès direct à l’espace de noms réseau de l’hôte au lieu d’un mappage classique des ports Docker.
Cela facilite la découverte sur le LAN et la communication avec les appareils, mais réduit également l’isolation réseau. Vérifiez quels services le conteneur ouvre sur l’hôte.
Le mode privilégié constitue une attribution importante de privilèges
Le conteneur officiel de Homey s’exécute avec les privilèges élevés. Cela lui confère des capacités bien plus étendues sur l’hôte et les périphériques qu’un service normal de l’App Store.
Utilisez uniquement l’image/la source officielle et maintenez-la à jour. N’ajoutez pas de logiciels sans rapport dans le même conteneur privilégié.
Connaître les ports du service Homey
La documentation actuelle de Homey répertorie les ports par défaut du serveur/pont, notamment 4859-4862. Le réseau de l’hôte signifie que ces services d’écoute apparaissent directement sur l’hôte ZimaOS.
Si un pare-feu hôte tel que ZFW est utilisé, assurez-vous que les ports LAN requis sont autorisés explicitement.
Terminer la configuration dans l’application mobile Homey
Une fois le conteneur démarré, ouvrez Homey sur iOS ou Android, ajoutez un nouveau Homey et sélectionnez Serveur auto-hébergé. Si la détection automatique échoue, la configuration actuelle de Homey permet de HOMEY_LOCAL_ADDRESS pour définir l’adresse IPv4 du réseau local de l’hôte.
Mettre à jour en récupérant l’image et en recréant le conteneur
Les instructions actuelles de Homey consistent à mettre à jour l’image et à recréer le conteneur tout en conservant le dossier persistant sur l’hôte. Les données sont préservées, car elles se trouvent en dehors du conteneur éphémère.
Sauvegarder le dossier persistant de Homey
Homey indique explicitement de sauvegarder les fichiers et dossiers stockés dans le .homey-shs chemin. Cette sauvegarde est plus importante que la conservation du conteneur lui-même.
FAQ Homey sur ZimaOS
L’utilisateur source a-t-il confirmé que Homey fonctionnait ?
Oui. Ils ont indiqué que l’installation Docker suggérée fonctionnait bien.
Les utilisateurs de ZimaOS doivent-ils installer Docker avec le script curl de Homey ?
Non. ZimaOS inclut déjà Docker ; utilisez uniquement la partie consacrée au conteneur/à Compose.
Pourquoi conserver /homey/user en dehors du conteneur ?
Ce répertoire contient l’état persistant de Homey et permet de mettre à jour ou de recréer le conteneur sans perdre la configuration.
