# f this returns "Image is up to date" then you can stop here
docker pull ghcr.io/home-assistant/home-assistant:stable
# stop the running container
docker stop homeassistant
# remove it from Docker's list of containers
docker rm homeassistant
# finally, start a new one
docker run -d \
--name homeassistant \
--restart=unless-stopped \
--privileged \
-e TZ=MY_TIME_ZONE \
-v /PATH_TO_YOUR_CONFIG:/config \
-v /run/dbus:/run/dbus:ro \
--network=host \
ghcr.io/home-assistant/home-assistant:stable
Las actualizaciones de Home Assistant en algunos casos usa una versión superior a la instalada en Raspbian OS, por lo que será necesario actualizar Python a versión sugerida.
Por ejemplo, la actualización Home Assistant 2020.12.1 indica que es necesario disponder de Python 3.8.6 o superior. Por lo que de no disponer de la vesión actualizada es necesario incorporar algunas instrucciones para cumplir con el requisito.
Las instrucciones para la actualización se pueden encontrar en:
Las instrucciones han sido probadas el 2020/12/29, un nuevo cambio podría ser necesario luego de un año, por lo que esta sección es relevante solo cuando aparece la alerta.
Procedimiento probado
Algunos programas requieren una versión más actualizada de Python, por ejemplo HomeAssistant. La lista de actualización de programas con sudo apt-get upgrade, puede estar un poco desactualizada respecto a las últimas actualizaciones de Python, debido a la realización de pruebas de compatibilidad.
Sin embargo se puede realizar una actualización intermedia para cumplir con requerimientos de otros programas siguiendo algunas instrucciones.
1. Python versiones disponibles
Verifique la versión a instalar disponible del sitio oficial de Python:
seleccione la versión que requiere y siga las instrucciones de la guía de la referencia. Para el ejemplo usamos a la fecha la versión 3.9. 0en lugar de la 3.7.3 que estaba disponible en el raspberry pi en la actualización oficial.
(la versión 3.9.2 mostró incompatibilidades con home-assistant al 2021-03-26, seguro en la próxima actualización será mejor)
requests 2.25.1 requires idna<3,>=2.5, but you'll have idna 3.1 which is incompatible.
2. Actualizar Rasberry Pi
Antes de iniciar el proceso, asegurarse de tener actualizado Rasberry Pi OS, puede seguir las instrucciones de: Raspberry Pi OS - Actualizar
3. Actualizar Python
Seguir las instrucciones del enlace de la referencia a partir del punto 2, con la versión que desea instalar.
Para conectar Home-Assistant al MQTT Mosquitto, se requiere configurar los parámetros de dirección, puerto, identificador de cliente, usuario y contraseña.
Los parámetros se ingresan en el archivo configuration.yaml con la instrucción:
Al reiniciar Home-assistant, debería operar con la configuración propuesta. Revisar la sección de Configuración/Registros, para observar si presenta algún problema de conexión.
La configuración de MQTT se realiza para: la conexión a MQTT y la revisión de mensajes de los dispositivos.
Mosquitto en Home Assistant
Para conectar Home-Assistant al broker Mosquitto, se requiere configurar los parámetros de conexión.
3. Mosquitto en Home Assistant
Para conectar Home-Assistant al broker Mosquitto, se requiere configurar los parámetros de conexión.
La forma más simple de configurar MQTT es usando la págine web en el menu de configuración/Integraciones.
Se usa el botón "+ añadir integración" para indicar los parámetros del servidor MQTT tal com "agente:" dirección ip o "localhost", el puerto es el mismo, se añade de ser el caso el usuario y la contraseña.
Al completar la configuración, deberá aparecer entre la lista de integraciones:
Al reiniciar Home-Assistant, debería iniciar con la configuración propuesta.
El reinicio se puede realizar desde la página en el menú Configuración/Controles del Servidor. Recuerde siempre validar el cambio de configuración antes de reiniciar Home-Assistant.
Home Assistant es una aplicación abierta, tipo local con la gestión básica para iniciar un proyecto de IOT para el hogar u oficina.
Permite acceder a la información y control de los dispositivos mediante una página web de configuración simplificada, personalizada, facilitando la instalación básica para iniciar con los conceptos básicos.
Ésta sección muestra notas tomadas como documentación simplificada al realizar un proyecto básico de IOT.
La forma de implementarla para este proyecto es un Raspberry Pi, por tener un servidor dedicado y de bajo consumo energético, aunque puede inslalarse en otras plataformas.
Para la implementación de un broker simplificado que gestione las conexiones con cada dispositivo se usa un Raspberry Pi con su sistema operativo "Raspberry pi OS" a partir del año 2020, antes conocido como"Raspbian". Dado que la documentación se inició en el 2018, se mantienen ambos nombres para la documentación.
En adelante, se considera que el Raspbian ya se encuentra instalado, actualizado, operativo y con dirección IP fija, de no ser así puede seguir las instrucciones de la sección Raspberry Pi OS-Instalar
A partir de aquí se resumen los pasos para la instalación de Home Assistant
Para la instalación se recomienda actualizar Rasbian a la fecha, puede usar las indicaciones en la sección correspondiente Raspbian-Actualizar
cd /srv
sudo mkdir homeassistant
sudo chown homeassistant:homeassistant homeassistant
Configurar un entorno virtual, ajustar la versión de Python acorde a la disponible y que se encuentre probada. El resto de instrucciones se mantienen iguales.
El programa se puede iniciar usando la instrucción. Esperar con paciencia, toma tiempo la primera ejecución.
hass
Durante el proceso de instalación, (o esperado al menos 5 minutos) una vez que se ha llegado al proceso de:
[homeassistant.bootstrap] Home Assistant initialized in 525.83s
[homeassistant.core] Starting Home Assistant
(MainThread) [homeassistant.core] Timer:starting
o en otro caso, observe los tiempos:
2021-07-23 06:06:09 WARNING (Recorder) [homeassistant.components.recorder.util] The system could not validate that the sqlite3 database at //home/homeassistant/.homeassistant/home-assistant_v2.db was shutdown cleanly
2021-07-23 06:08:15 WARNING (MainThread) [homeassistant.bootstrap] Waiting on integrations to complete setup: cloud
2021-07-23 06:11:38 WARNING (MainThread) [homeassistant.bootstrap] Waiting on integrations to complete setup: zeroconf
se debe ingresar vía web para ingresar los datos de usuario, palabra clave, ubicación geográfica y así completar la instalación.
Para el ejemplo mostrado debería ingresar desde un navegador de internet a la dirección asignada en el proceso de instalación:
192.168.10.100:8123
Cuando se termine el proceso de instalación en la página web, será necesario configurar el inicio automático, así al reiniciar el Raspberry Pi, todo continúe funcionando normalmente.
- se debe salir del proceso de la consola con las teclas Ctrl-C
- regresar al usuario básico con la instrucción: exit
4. Configura el inicio automático
Crear un archivo de servicio con nombre semejante al mostrado en la instrucción:
Para probar que todo funciona bién se reinicia el Raspberry Pi con la instruccion sudo reboot
5. Modo avanzado para administrador
Para comprobar que las configuraciones sean las correctas u otras opciones de administrador, se puede activar las opciones de modo avanzado para el usuario administrador desde la sección "administrador/modo avanzado"
Se activan y muestran los botones en "configuración/controles de servidor"
Periódicamente se publican actualizaciones para Home Asssistant en el sitio web. La versión instalada se puede revisar en el sitio web local, sección de "Configuración/información".
Las instrucciones para actualizar Home Assistant se realizan mediante una conexión terminal ssh que consiste en:
Si la instalación fue realizada con Docker, se usan las siguientes instrucciones:
# if this returns "Image is up to date" then you can stop here
docker pull ghcr.io/home-assistant/home-assistant:stable
# stop the running container
docker stop homeassistant
# remove it from Docker's list of containers
docker rm homeassistant
sudo docker run -d \
--name homeassistant \
--restart=unless-stopped \
--privileged \
-e TZ=Americas/Guayaquil \
-v /home/girni/homeassistant:/config \
--network=host \
ghcr.io/home-assistant/home-assistant:stable
