La solución original sigue estando inusualmente actualizada. Un miembro de la comunidad enlazó directamente a las instrucciones oficiales de Homey para Linux y utilizó un contenedor Docker con red del host, modo privilegiado, reinicio automático y un directorio persistente. ~/.homey-shs directorio. El autor original respondió que la instalación funcionó.
Las páginas oficiales de soporte actuales de Homey siguen utilizando la misma arquitectura de contenedor y ahora también ofrecen un ejemplo de Docker Compose. En ZimaOS, Compose suele ser más fácil de documentar y reproducir que un comando aislado de docker run comando.
Comprueba los requisitos mínimos actuales de Homey
El servidor autoalojado de Homey requiere actualmente:
- CPU Intel/AMD o Arm de 64 bits;
- al menos 1 GB de RAM disponible;
- al menos 1 GB de almacenamiento disponible;
- una dirección IP o ruta LAN dedicada a la que puedan acceder los clientes.
ZimaOS ya proporciona Docker, así que no ejecutes en el host el script genérico de Homey para «instalar Docker».
La solución original utilizó la arquitectura oficial de Docker Run de Homey
El comando de origen utilizado fue:
-
--network host; -
--privileged; -
--restart unless-stopped; - una carpeta persistente del host asignada a
/homey/user/; -
ghcr.io/athombv/homey-shs.
El autor original confirmó que el servidor se instaló y funcionó.
La documentación actual de Homey también proporciona Docker Compose
El ejemplo de Compose mantenido por Homey utiliza el mismo diseño:
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/userConsulta el flujo actual de Compose para el servidor autoalojado de Homey.
Usa una ruta persistente bien definida en ZimaOS
La documentación oficial ~/.homey-shs la ruta es válida en un shell de Linux general, pero en ZimaOS es más limpio elegir una ubicación de almacenamiento explícita y con permisos de escritura, como una carpeta AppData dedicada dentro del espacio de almacenamiento del que realmente haces copias de seguridad.
Asigna esa carpeta del host a /homey/user y documentarlo antes de futuras reinstalaciones.
La red del host es intencionada
El archivo Compose oficial de Homey utiliza network_mode: host, lo que proporciona al contenedor acceso directo al espacio de nombres de red del host en lugar del mapeo de puertos habitual de Docker.
Esto facilita la detección en la LAN y la comunicación con los dispositivos, pero también reduce el aislamiento de red. Revisa qué servicios abre el contenedor en el host.
El modo privilegiado concede permisos importantes
El contenedor oficial de Homey se ejecuta con privilegios. Esto proporciona al contenedor capacidades de acceso al host y a los dispositivos mucho mayores que las de un servicio normal de la App Store.
Usa únicamente la imagen/fuente oficial y mantenla actualizada. No añadas software no relacionado al mismo contenedor con privilegios.
Conocer los puertos del servicio de Homey
La documentación actual de Homey indica los puertos predeterminados del servidor/puente, incluidos 4859-4862. La red del host hace que esos servicios de escucha aparezcan directamente en el host de ZimaOS.
Si se usa un firewall del host, como ZFW, asegúrate de permitir deliberadamente los puertos LAN necesarios.
Completar la configuración en la aplicación móvil de Homey
Cuando el contenedor esté en ejecución, abre Homey en iOS o Android, añade un Homey nuevo y selecciona Servidor autoalojado. Si la detección automática falla, la configuración actual de Homey permite HOMEY_LOCAL_ADDRESS para definir la dirección IPv4 de la LAN del host.
Actualizar extrayendo la imagen y recreando el contenedor
Las instrucciones actuales de Homey indican actualizar la imagen y recrear el contenedor manteniendo la carpeta persistente del host. Los datos sobreviven porque están fuera del contenedor desechable.
Hacer una copia de seguridad de la carpeta persistente de Homey
Homey indica explícitamente que se deben hacer copias de seguridad de los archivos y carpetas almacenados en la ruta elegida .homey-shs ruta. Esa copia de seguridad es más importante que conservar el contenedor.
Preguntas frecuentes sobre Homey en ZimaOS
¿Confirmó el usuario de origen que Homey funcionaba?
Sí. Dijeron que la instalación de Docker sugerida funcionaba bien.
¿Deben los usuarios de ZimaOS instalar Docker con el script curl de Homey?
No. ZimaOS ya incluye Docker; usa solo la parte del contenedor/Compose.
¿Por qué hacer persistente /homey/user fuera del contenedor?
Ese directorio contiene el estado persistente de Homey y permite actualizar o recrear el contenedor sin perder la configuración.
