Cómo instalar Home Assistant en Saplo: integraciones y automatización

Tienes dispositivos de varios fabricantes y quieres centralizar su gestión y automatización en un solo lugar. Home Assistant te permite combinar servicios compatibles en un panel común. En este tutorial, te mostraremos cómo instalar Home Assistant en Saplo, completar la configuración inicial y probar una automatización sencilla sin conectar ningún hardware.

Cuándo tiene sentido Home Assistant en Saplo

La instalación en Saplo es ideal para integraciones que usan internet y como entorno para aprender automatización. El panel funciona en un servidor en el centro de datos y está disponible a través de HTTPS. Sin embargo, la compatibilidad de un dispositivo específico depende de su integración, método de comunicación y requisitos del fabricante.

El Box no tiene acceso automático a tu red doméstica. Introducir la dirección privada de un dispositivo, por ejemplo 192.168.1.20, no garantizará la conexión desde el servidor Saplo. Los dispositivos locales requieren una conectividad configurada por separado, por ejemplo, un túnel VPN con las rutas y reglas de acceso adecuadas. La instalación de Home Assistant por sí sola no crea tal túnel. El descubrimiento automático por mDNS o SSDP tampoco funcionará solo porque conectes redes VPN.

La receta no proporciona USB, por lo que no podrás conectar directamente un coordinador Zigbee o Z-Wave doméstico. Si la base de tu sistema son sensores locales y controles que funcionan sin internet, considera dejar el centro de automatización en casa. Con una instalación remota, la pérdida de internet doméstico corta la comunicación con los dispositivos, incluso si el propio panel en Saplo sigue funcionando.

Requisitos y alojamiento de Home Assistant en Saplo

El plan más económico que cumple los requisitos mínimos de esta receta es Box M por 63 € al año. La receta requiere 2048 MB de RAM y 10 GB de espacio en disco. Si ya hay otras aplicaciones ejecutándose en el Box, verifica los recursos disponibles antes de la instalación. Un historial de mediciones creciente y nuevas integraciones aumentarán la demanda de memoria y disco.

Prepara un Box activo, el nombre de la aplicación y la dirección donde estará disponible. No necesitas crear una base de datos separada ni instalar Docker manualmente. Los detalles del servicio están en la página de Home Assistant en Saplo.

Saplo ejecuta Home Assistant en la imagen de contenedor oficial. Esta es una instalación tipo Home Assistant Container, sin Supervisor ni la tienda de complementos conocida de Home Assistant OS. Las integraciones añadidas en la configuración de Home Assistant son una función diferente a las aplicaciones gestionadas por Supervisor. Las diferencias se describen en la documentación oficial de instalación de Container.

Instalación paso a paso

1. Inicia sesión en el panel de Saplo y abre el catálogo de aplicaciones.
2. Busca Home Assistant y comienza a añadir la aplicación.
3. Ponle un nombre, por ejemplo, my-smart-home, y elige un Box con los recursos adecuados.
4. Elige una dirección de aplicación disponible. Puedes empezar con el subdominio *.saploapp.pl.
5. Confirma la instalación y espera a que finalice en el panel. El tiempo depende, entre otros factores, de la descarga de la imagen y de la carga del servidor.
6. Abre la dirección HTTPS exacta que se muestra junto a la aplicación. Saplo prepara el dominio y el certificado SSL durante el inicio.
7. Accede directamente al asistente de primer inicio y crea la cuenta del propietario.

Utiliza el dominio que se ve en el panel, sin añadir el puerto 8123. La dirección homeassistant.local, que se encuentra en las guías de instalación doméstica, no es la dirección de tu aplicación en Saplo.

Primer inicio de sesión y configuración de la casa

En el asistente de nueva instalación, introduce tu nombre de usuario y una contraseña fuerte y única. La cuenta de propietario de Home Assistant la creas tú mismo y es independiente de tu cuenta en el panel de Saplo. Guarda tus datos en un gestor de contraseñas y no dejes el asistente sin terminar en una dirección pública.

Establece la ubicación de tu casa, verifica la zona horaria Europe/Warsaw y las unidades. Indica la ubicación de los dispositivos que quieres controlar, no la del centro de datos. Esto es importante para las horas de amanecer y atardecer. Elige la configuración de uso compartido de datos y finaliza la configuración. El proceso del asistente se describe en la documentación del primer inicio.

Primera integración sin hardware adicional

Para empezar, añade Workday, que es una integración de días laborables. Esto te permitirá probar la integración sin una cuenta de fabricante y sin conexión a la red doméstica.

1. Abre Ajustes > Dispositivos y servicios.
2. Selecciona añadir una integración y busca Workday.
3. Establece España como país y un nombre, por ejemplo, "Día laborable".
4. Comprueba los días de la semana seleccionados y los ajustes de festivos. Deja el desplazamiento de días en cero si quieres comprobar el día actual.
5. Finaliza la configuración, abre la integración añadida y comprueba el estado de su entidad.

Una entidad representa una lectura o función específica, en este caso, información sobre un día laborable. Puedes encontrar instrucciones para añadir Workday en la guía oficial de integración. Añade las integraciones siguientes una por una y comprueba su documentación antes de introducir los datos de inicio de sesión.

Primera automatización y prueba de funcionamiento

Prepara una prueba que muestre una notificación en Home Assistant a la hora elegida. No requiere teléfono, lámpara ni sensor.

1. Abre Ajustes > Automatizaciones y escenas, añade una automatización y elige crear una regla vacía.
2. Añade un disparador de tiempo, ajustando la hora a unos minutos más tarde que la hora actual en la zona configurada.
3. Para la prueba, deja la sección de condiciones vacía.
4. Añade la acción persistent_notification.create. Establece el título "Test Saplo" y el contenido "La automatización funciona".
5. Guarda la regla como "Test de notificación" y asegúrate de que está activada.
6. Espera hasta la hora elegida. Comprueba la notificación en la interfaz de Home Assistant y el rastro de ejecución de la automatización.
7. Después de una prueba exitosa, desactiva o elimina la regla de prueba para que no se ejecute todos los días.

El editor se describe en la documentación de automatización, y los campos de acción se encuentran en la documentación de Persistent Notification. Esta es una notificación dentro del panel, no un mensaje push en el teléfono.

La ejecución manual de la acción ayuda a verificar su configuración, pero no confirma el funcionamiento del disparador de tiempo. Por lo tanto, también espera la ejecución programada. Luego, cierra sesión, vuelve a iniciarla y comprueba si la integración y la regla guardada siguen siendo visibles.

Qué comprobar cuando algo no funciona

La página no se abre después de la instalación. Comprueba el estado de la aplicación en el panel de Saplo y la dirección HTTPS completa. Si ves un error, facilita al Soporte de Saplo el nombre de la aplicación, la hora del intento y el mensaje. No elimines una instalación que ya contenga una configuración solo para volver a intentarlo.

Home Assistant no encuentra dispositivos en casa. Esto es lo esperado con esta receta. Comprueba si la integración seleccionada utiliza la nube del fabricante o requiere una conexión directa al dispositivo. Para una conexión local, necesitas una ruta de red disponible y una integración que admita este modo de funcionamiento. No expongas el panel del dispositivo a internet como solución provisional.

La automatización no se inicia a tiempo. Comprueba la zona horaria, la activación de la regla y la hora configurada. Abre el seguimiento de la ejecución para ver si la regla se ha activado y en qué paso se ha detenido.

No hay tienda de complementos. Esta es una característica de la instalación de Container. Las guías que requieren Supervisor y los complementos de Home Assistant OS no se aplican directamente a esta instalación.

Copias de seguridad y expansión futura

Box M no incluye la copia de seguridad en el precio del plan. Asegúrate de tener una copia de tus datos y la configuración de Home Assistant fuera de Box, especialmente antes de una actualización o un cambio importante. Guardar las automatizaciones o un directorio de configuración persistente no reemplaza una copia de seguridad. También, verifica la posibilidad de restaurar la copia antes de confiar la gestión diaria de tu casa a la instalación.

Después del primer intento exitoso, añade una integración a la vez y observa el uso de los recursos. Iniciar el panel no significa que todos los dispositivos sean accesibles. Revisa cada conexión y cada automatización por separado.

Si Home Assistant necesita acceder a dispositivos en casa sin exponerlos a internet, una red VPN privada te será útil. Hemos descrito cómo instalar Headscale, tu propio servidor Tailscale, en Saplo.

Para empezar, elige Home Assistant en Saplo en un Box M por 63 € al año. Completa el asistente, añade Workday y realiza una prueba de notificación. Luego, selecciona las integraciones para tus dispositivos y la forma de conexión con tu casa.