Blog

Home Assistant en tu Raspberry PI

5 de febrero de 2026 /

Cómo instalar Home Assistant en Raspberry Pi (Paso a paso para tu Camper o Casa)

¡Bienvenidos de nuevo! En el artículo anterior analizamos qué tipos de instalación existen para domotizar nuestra Autocaravana. Hoy pasamos a la acción: vamos a instalar Home Assistant OS en una Raspberry Pi 4 o 5.

Aunque este tutorial está enfocado al mundo camper, los pasos son exactamente los mismos si quieres domotizar tu casa. ¡Vamos a ello!

1. Requisitos previos

Antes de empezar, asegúrate de tener todo lo necesario sobre la mesa:

  • Raspberry Pi 4 o 5 (recomendado al menos 2GB de RAM).
  • Tarjeta MicroSD (mínimo 32GB recomendados, de buena velocidad).
  • Lector de tarjetas para tu ordenador.
  • PC o Mac para preparar la instalación.

2. Preparando la MicroSD con Raspberry Pi Imager

El primer paso es descargar la herramienta oficial que hará todo el trabajo sucio por nosotros.

  1. Ve a la web oficial de Raspberry Pi Software y descarga Raspberry Pi Imager. Instálalo como cualquier otro programa (siguiente, siguiente y terminar).
  2. Inserta la MicroSD en tu ordenador y abre el programa.
  3. Selecciona el modelo: Elige Raspberry Pi 4 o 5 según la que tengas.
  4. Selecciona el Sistema Operativo: Entra en Other specific-purpose OS > Home automation > Home Assistant. Elige la primera opción (la que tiene el logo azul).
  5. Selecciona el almacenamiento: Elige tu tarjeta MicroSD.
  6. Dale a Escribir. Acepta el aviso de que se borrarán los datos y espera unos minutos a que termine de escribir y verificar.

3. Configuración WiFi (Sin cables de red)

Si vas a usar Home Assistant en una autocaravana o no tienes un cable de red a mano, sigue estos pasos antes de meter la tarjeta en la Raspberry.

  1. Saca y vuelve a meter el lector de tarjetas en tu PC. Se abrirá una unidad llamada hassos-boot.
  2. Importante: En Windows, asegúrate de que puedes ver las extensiones de los archivos (En el explorador: Vista > Mostrar > Extensiones de nombre de archivo).
  3. Dentro de la unidad hassos-boot, crea una carpeta llamada CONFIG (en mayúsculas).
  4. Entra en ella y crea otra carpeta llamada network.
  5. Dentro de network, crea un archivo de texto llamado my-network y bórrale la extensión .txt al final.

El código de configuración

Abre ese archivo con un editor de texto (como el Bloc de notas) y pega el siguiente código, sustituyendo el nombre de tu red y tu contraseña:

[connection]
id=my-network
uuid=d55162b4-6156-481d-93e5-9d332619e995
type=802-11-wireless

[802-11-wireless]
mode=infrastructure
ssid=NOMBRE_DE_TU_WIFI_AQUÍ
powersave=1

[802-11-wireless-security]
auth-alg=open
key-mgmt=wpa-psk
psk=TU_CONTRASEÑA_AQUÍ

[ipv4]
method=auto

[ipv6]
addr-gen-mode=stable-privacy
method=auto

Nota de seguridad: No te preocupes por dejar este archivo ahí, Home Assistant lo leerá en el primer arranque para conectarse y lo borrará automáticamente por seguridad.

4. Primer arranque y acceso

Ahora ya puedes sacar la MicroSD de tu PC y meterla en la Raspberry Pi. Conéctale la alimentación y espera unos 5-10 minutos.

Para entrar al panel de control:

  1. Abre un navegador en tu móvil o PC (que esté conectado a la misma WiFi).
  2. Escribe en la barra de direcciones: http://homeassistant.local:8123

¿No carga la página? Usa la IP

A veces el nombre .local falla. En ese caso, necesitas la dirección IP (ejemplo: 192.168.1.15).

  • Opción A: Mira en la pegatina de tu router los datos de acceso, entra en la configuración y busca «dispositivos conectados».
  • Opción B : Descarga la app Fing en tu móvil. Escanea tu red WiFi y verás rápidamente un dispositivo llamado «homeassistant». Copia ese número seguido de :8123.

5. Configuración inicial

Una vez dentro, el asistente te guiará:

  1. Crea tu usuario y contraseña (¡no pongas una fácil!).
  2. Elige tu ubicación. Si es para la camper, puedes poner una cualquiera, ya que más adelante veremos cómo hacer que se actualice sola por GPS.
  3. Home Assistant detectará automáticamente dispositivos que ya tengas en tu red. Puedes añadirlos ahora o dejarlo para más tarde.

¡Listo! Ya tienes tu cerebro domótico funcionando.

¿Qué viene después?

Ahora que ya tenemos la instalación lista en una Raspberry PI, continuaremos y realizaremos la instalación en un Mini PC, una opción muy potente para quienes quieren ir un paso más allá en su sistema. ¡No te lo pierdas!

¿Tienes alguna duda con el archivo de configuración? Déjala en los comentarios y te echamos una mano.

Y si te interesa comprar una Raspberry Pi te dejo un par de enlaces:

🛒 Sensor Temperatura/Humedad (Zigbee): https://amzn.to/40GeCcu

🛒 Coordinador Zigbee SONOFF: https://amzn.to/4smQOpU

🛒 Raspberry Pi 4 4GB : https://amzn.to/4l7WPEI

🛒 Raspberry Pi 5 4 GB: https://amzn.to/3MVMIpW

MiniPcs con 16 Gb de RAM:

🛒 NiPoGi Mini PC AK1 Plus: https://amzn.to/4br6MZB

🛒 GMKtec Mini PC Intel Twin Lake N95: https://amzn.to/3OJi8QU

MiniPcs con 8 Gb de RAM:

🛒 NiPoGi Pinova P1: https://amzn.to/3Pf2GvR

🛒 NiPoGi Mini PC N100: https://amzn.to/3MGmJCP

Sobre los enlaces en este vídeo:

🎁 Transparencia: Algunos de los links que aparecen aquí son de afiliación. Como afiliado de Amazon, percibo ingresos por compras adscritas que cumplen los requisitos aplicables.Si decides comprar algo a través de ellos, nosotros recibimos una pequeña comisión sin que a ti te cueste ni un céntimo extra. ¡Es una forma genial de apoyarnos para que sigamos compartiendo rutas y consejos! Gracias por estar ahí.

¿Algo no ha salido como esperabas? (Solución de errores)

Incluso siguiendo los pasos, a veces la tecnología se pone caprichosa. Aquí tienes las soluciones a los problemas más frecuentes:

1. El archivo my-network no funciona y no se conecta a la WiFi

Este es el error más común. Si después de 10 minutos no ves a la Raspberry en tu red, revisa esto:

  • La extensión oculta: Asegúrate de que el archivo se llama my-network y NO my-network.txt. Si ves un icono de folio con líneas de texto, es probable que Windows te haya vuelto a poner el .txt sin avisar.
  • El nombre de la red (SSID): Respetar mayúsculas, minúsculas y espacios es vital. No es lo mismo MiWiFi que miwifi.
  • Cuidado con las comillas: No pongas el nombre de tu WiFi ni la contraseña entre comillas en el código. Ponlo tal cual después del signo =.

2. No puedo entrar por homeassistant.local:8123

Si el enlace no carga, no entres en pánico:

  • Fuerza el protocolo: A veces el navegador intenta entrar por «https». Asegúrate de escribirlo exactamente así: http://homeassistant.local:8123 (con HTTP, sin la S).
  • Aislamiento de red: Algunos routers tienen una opción llamada «AP Isolation» o «Red de invitados». Si tu PC o móvil está en una red de invitados, no verá a la Raspberry. Asegúrate de que ambos están en la misma red principal.

3. La luz roja/verde de la Raspberry Pi

  • Luz roja fija: Significa que tiene energía. Si parpadea, es posible que tu fuente de alimentación no tenga fuerza suficiente (necesitas al menos 3A).
  • Luz verde intermitente: ¡Buena señal! Significa que está leyendo la tarjeta MicroSD. Si la luz verde no hace nada de nada, es posible que la grabación con Raspberry Pi Imager haya fallado; prueba a grabarla de nuevo.

4. He cambiado la WiFi de casa o de la autocaravana

Si cambias de router o de contraseña, Home Assistant perderá la conexión. Tienes dos opciones:

  • La fácil: Volver a meter la MicroSD en el PC y repetir el paso del archivo my-network.
  • La pro: Si consigues conectar la Raspberry por cable de red una sola vez, podrás cambiar la WiFi desde el menú Ajustes > Sistema > Red dentro de la propia interfaz de Home Assistant.