Si ya tienes un servidor con Proxmox en marcha en casa, estás a menos de media hora de tener un sistema de domótica serio, estable y con todas las garantías de un entorno profesional. Instalar Home Assistant en Proxmox como máquina virtual es, hoy por hoy, la forma más robusta de montar tu smart home: backups automáticos, snapshots con un clic, y el sistema completamente aislado del resto de servicios que puedas tener corriendo en el servidor.
En esta guía te explicamos el proceso completo, desde cero: creamos la máquina virtual con la configuración correcta, importamos el disco de Home Assistant OS y te dejamos el sistema listo para empezar a conectar dispositivos. Sin atajos ni pasos omitidos.
¿Qué necesitas antes de empezar?
Antes de ponerse manos a la obra, repasa que tienes todo lo necesario. No hace falta gran cosa, pero hay dos o tres detalles que, si los pasas por alto, te van a hacer perder tiempo luego.
En cuanto al hardware y software del servidor, necesitas Proxmox VE 7.x o superior (nosotros recomendamos la versión 8.x), con la virtualización activada en la BIOS del equipo (Intel VT-x o AMD-V). Para la máquina virtual en sí, reserva al menos 2 GB de RAM —aunque con 4 GB vas mucho más cómodo—, un mínimo de 32 GB de almacenamiento y al menos 2 núcleos de CPU.
Por otro lado, necesitas acceso a la interfaz web de Proxmox en https://IP-DE-TU-SERVIDOR:8006 y acceso por SSH al servidor para ejecutar los comandos que verás más adelante. La imagen de Home Assistant OS la descargaremos durante el proceso, así que no hace falta que la tengas ya.
Paso 1: descargar la imagen de Home Assistant OS
El primer paso es obtener la imagen oficial de Home Assistant OS en formato .qcow2, que es el formato de disco que entiende el hipervisor QEMU/KVM que usa Proxmox. Conéctate al servidor por SSH y ejecuta los siguientes comandos, sustituyendo X.X por la versión más reciente disponible en el repositorio oficial de GitHub:
wget https://github.com/home-assistant/operating-system/releases/download/X.X/haos_ova-X.X.qcow2.xz -P /var/lib/vz/images/
unxz /var/lib/vz/images/haos_ova-X.X.qcow2.xzEs importante descargar el archivo con su nombre original y descomprimirlo en dos pasos separados. Si usas -O para renombrar el archivo durante la descarga, wget le asignará el nombre final antes de que esté descomprimido, lo que provoca que unxz no lo encuentre y que qemu-img rechace el archivo al importarlo con el error «Image is not in qcow2 format».
Puedes consultar cuál es la última versión estable directamente en la página de releases del proyecto: releases oficiales de Home Assistant OS en GitHub.
Si prefieres descargar el archivo desde tu ordenador y subirlo al servidor, también puedes hacerlo con SCP:
scp haos_ova-X.X.qcow2 root@IP-PROXMOX:/var/lib/vz/images/Paso 2: crear la máquina virtual en Proxmox
Ahora vamos a crear la VM en la interfaz web de Proxmox. Haz clic derecho sobre tu nodo en el panel izquierdo y selecciona Create VM. El asistente tiene varias pestañas; te detallamos cómo rellenar cada una.
Pestaña General
Pon un VM ID libre, por ejemplo 200, y el nombre que quieras darle a la máquina: HomeAssistant es suficientemente descriptivo. Sin más cambios en esta pantalla.
Pestaña OS
Selecciona Do not use any media. No vamos a usar ninguna ISO porque el sistema operativo lo vamos a importar directamente desde el disco .qcow2. En Guest OS elige Linux y en Version selecciona la opción 6.x - 2.6 Kernel.
Pestaña System
Esta es la pestaña más importante y donde más gente se equivoca. Configúrala exactamente así:
- Machine:
q35— imprescindible, no uses i440fx - BIOS:
OVMF (UEFI)— Home Assistant OS lo requiere - EFI Storage: elige tu almacenamiento, por ejemplo
local-lvm - SCSI Controller:
VirtIO SCSI
Si dejas el BIOS clásico o el tipo de máquina incorrecto, la VM no arrancará. Es el error más frecuente en esta instalación, así que revísalo bien antes de continuar.
Pestaña Disks
Elimina cualquier disco que aparezca por defecto. El disco lo importaremos en el siguiente paso directamente desde la imagen .qcow2, así que aquí no añadas nada.
Pestaña CPU
Asigna 1 socket con 2 o 4 núcleos según la potencia de tu servidor. Lo más importante aquí es que el tipo de CPU sea host, no el valor genérico por defecto. Esto mejora el rendimiento y, sobre todo, garantiza la compatibilidad con dispositivos USB como los adaptadores Zigbee.
Pestaña Memory
Asigna 4096 MiB (4 GB). Desactiva el ballooning: puede causar comportamientos extraños en Home Assistant OS y no aporta nada relevante en este escenario.
Pestaña Network
Modelo VirtIO (paravirtualized) y bridge vmbr0, que normalmente es el bridge de red principal en Proxmox. Estas opciones ofrecen el mejor rendimiento de red disponible.
En la pantalla de confirmación, desmarca la opción «Start after created». Todavía no queremos arrancar la VM porque falta importar el disco. Haz clic en Finish.
Paso 3: importar el disco de Home Assistant OS
De vuelta en la terminal SSH, ejecuta este comando para importar la imagen como disco de la VM. Sustituye 200 por el ID de tu VM y local-lvm por el nombre de tu almacenamiento:
qm importdisk 200 /var/lib/vz/images/haos_ova-X.X.qcow2 local-lvmVerás una barra de progreso. Cuando termine, el disco aparecerá en la interfaz web como Unused Disk 0, dentro de la sección Hardware de tu VM.
Para añadirlo a la VM, haz doble clic sobre él y configúralo así:
- Bus/Device: SCSI →
scsi0 - Cache: Write Back (mejor rendimiento)
- Discard: activado si usas SSD o NVMe
Haz clic en Add. El disco ya está conectado a la VM.
Paso 4: configurar el orden de arranque
Para que la VM arranque desde el disco que acabamos de importar, ve a VM > Options > Boot Order, haz clic en Edit y asegúrate de que scsi0 está habilitado y es el primero en la lista. Desactiva cualquier otra opción que aparezca marcada, como ide2 o net0. Guarda los cambios.
Paso 5: desactivar Secure Boot en la VM
Antes del primer arranque real hay un paso adicional que no puedes saltarte: desactivar Secure Boot en el firmware UEFI de la VM. Home Assistant OS no firma sus bootloaders con las claves que reconoce OVMF, así que con Secure Boot activo la VM queda bloqueada con un error de acceso denegado y no arranca.
Este ajuste afecta únicamente al firmware virtual de esta VM, no al Secure Boot de tu servidor físico ni al del resto de máquinas virtuales.
Para desactivarlo, arranca la VM por primera vez y en cuanto aparezca el logo en la consola, pulsa Esc rápidamente para entrar en el menú del firmware. Una vez dentro:
- Entra en Device Manager
- Selecciona Secure Boot Configuration
- Desmarca la opción Attempt Secure Boot
- Pulsa F10 para guardar los cambios
- Selecciona Reset para reiniciar la VM
A partir de aquí la VM arrancará sin restricciones. Si te pierdes el momento para pulsar Esc y la VM pasa de largo, apágala desde Proxmox y vuelve a intentarlo: tienes una ventana de apenas un segundo cuando aparece el logo.
Paso 6: primer arranque y acceso a Home Assistant
Ya está todo listo. Selecciona la VM en el panel izquierdo, haz clic en Start y abre la consola. Verás cómo Home Assistant OS arranca por primera vez y comienza a descargar e inicializar los contenedores del sistema.
Este proceso puede tardar entre 5 y 15 minutos en el primer arranque, dependiendo de la velocidad de tu conexión y del disco. Es completamente normal; no toques nada mientras tanto.
Cuando el sistema esté listo, aparecerá la pantalla de login de HAOS en la consola. Escribe login sin contraseña y luego ejecuta:
ha network infoAnota la dirección IP que aparece. Con ella ya puedes acceder a la interfaz web de Home Assistant desde cualquier navegador de tu red:
http://192.168.X.X:8123Te recomendamos asignar una IP estática a esta VM desde tu router, usando la dirección MAC de la interfaz de red virtual. Así siempre tendrá la misma IP y no tendrás que buscarlo cada vez.
Paso 7: configuración inicial de Home Assistant
La primera vez que accedas al puerto 8123, Home Assistant te mostrará su asistente de configuración inicial. El proceso es sencillo: creas la cuenta de administrador con tu nombre, usuario y contraseña, seleccionas tu ubicación geográfica —que Home Assistant usa para las automatizaciones basadas en el sol y el clima— y ajustas la zona horaria y las unidades de temperatura.
Después de eso, Home Assistant escaneará tu red local y te mostrará los dispositivos compatibles que haya detectado automáticamente: routers, dispositivos Chromecast, bombillas inteligentes, altavoces Sonos y muchos otros. Puedes integrarlos en ese momento o dejarlo para más adelante desde el menú de Configuración > Dispositivos e integraciones.
Automatizaciones y pasos recomendados tras la instalación
Con Home Assistant ya funcionando en Proxmox, hay algunas cosas que merece la pena configurar desde el principio para sacarle el máximo partido a esta combinación.
Backups automáticos desde Proxmox
Una de las mayores ventajas de correr Home Assistant en Proxmox es que puedes programar backups completos de la VM sin tocar nada desde Home Assistant. Ve a Datacenter > Backup, haz clic en Add y configura un backup diario o semanal en modo snapshot o stop. Si alguna vez algo falla, restauras la VM en minutos y no pierdes nada.
Ampliar el almacenamiento
El disco de Home Assistant OS pesa unos 6 GB al instalarse, pero con el tiempo y los add-ons el espacio puede quedarse justo. Para ampliar el disco de la VM sin apagarla, ejecuta desde la terminal de Proxmox:
qm resize 200 scsi0 +32GHome Assistant OS detectará el espacio adicional automáticamente en el siguiente reinicio.
Pasar un adaptador USB Zigbee a la VM
Si usas un adaptador Zigbee USB —como el Sonoff Zigbee 3.0 Dongle Plus o el HUSBZB-1— para controlar dispositivos en casa, puedes pasarlo directamente a la VM. Ve a Hardware > Add > USB Device, selecciona tu adaptador por Vendor/Device ID y reinicia la VM. Desde Home Assistant podrás usarlo con ZHA o Zigbee2MQTT sin ningún problema adicional.
Problemas frecuentes y cómo solucionarlos
La VM no arranca o muestra pantalla negra
El motivo más habitual es haber seleccionado el tipo de máquina i440fx en lugar de q35, o haber dejado el BIOS en modo SeaBIOS en lugar de OVMF. Revisa ambas opciones en Hardware > Machine y en Options > BIOS. También verifica que el orden de arranque tiene scsi0 en primer lugar.
No aparece la interfaz web en el puerto 8123
El primer arranque tarda. Si han pasado menos de 10 minutos desde que iniciaste la VM, espera un poco más antes de preocuparte. Si ya ha pasado tiempo suficiente, consulta la IP actual desde la consola de Proxmox con ha network info y comprueba que tu firewall no bloquea el puerto 8123.
El disco importado no aparece en Hardware
Comprueba que el comando qm importdisk terminó sin errores. Si usas un storage diferente de local-lvm, asegúrate de haber escrito el nombre exacto. Puedes ver los storages disponibles ejecutando pvesm status en la terminal de Proxmox.
Home Assistant no detecta el adaptador USB Zigbee
Primero verifica que el adaptador aparece en el servidor con lsusb desde la terminal de Proxmox. Si aparece pero Home Assistant no lo ve, comprueba que el tipo de CPU de la VM está configurado como host y no como el tipo genérico por defecto.
Material recomendado para tu instalación de Home Assistant
Aviso: Este artículo contiene enlaces de afiliado de Amazon. Si realizas una compra a través de ellos, recibimos una pequeña comisión sin coste adicional para ti. Esto nos ayuda a mantener el blog. Gracias por tu apoyo.
Si estás montando tu sistema de domótica con Home Assistant en Proxmox y todavía no tienes el hardware para empezar, aquí tienes los dispositivos que usamos en tecnocripto y que te recomendamos sin dudarlo.
Sonoff Zigbee 3.0 USB Dongle Plus — El adaptador Zigbee más popular y compatible con Home Assistant. Funciona perfectamente pasado a la VM de Proxmox y es compatible tanto con ZHA como con Zigbee2MQTT. Consulta el precio actualizado en Amazon. Ver precio en Amazon
Mini PC para servidor Proxmox — Si todavía no tienes servidor y buscas una opción compacta, eficiente y silenciosa para correr Proxmox en casa, los mini PCs de la gama N100 o N305 son una excelente elección. Bajo consumo, más que suficiente potencia para Home Assistant y varias VMs más. Consulta el precio actualizado en Amazon. Ver precio en Amazon
Preguntas frecuentes sobre Home Assistant en Proxmox
¿Puedo instalar Home Assistant en Proxmox con un contenedor LXC en lugar de una VM?
Técnicamente es posible, pero no es la opción recomendada para Home Assistant OS. Los contenedores LXC tienen restricciones de acceso a hardware —especialmente USB y Bluetooth— que complican mucho la domótica real. Con una VM completa tienes acceso total al hardware y ninguna limitación de este tipo.
¿Qué diferencia hay entre Home Assistant OS, Supervised, Core y Container?
HAOS es la versión completa: incluye el supervisor, todos los add-ons oficiales y el sistema operativo optimizado. Es la opción más recomendada para instalar en Proxmox. Las otras variantes tienen restricciones en los add-ons disponibles o requieren una configuración manual mucho más compleja.
¿Cuántos recursos necesita Home Assistant corriendo en Proxmox?
Para una instalación básica con pocos dispositivos, con 2 vCPU y 2 GB de RAM es suficiente. Si tienes muchos dispositivos, add-ons como Node-RED, Zigbee2MQTT o bases de datos adicionales, lo cómodo son 4 vCPU y 4 GB de RAM.
¿Puedo migrar mi Home Assistant de una Raspberry Pi a Proxmox?
Sí, y es más sencillo de lo que parece. Haz un backup completo desde el menú Ajustes > Sistema > Copias de seguridad de tu instalación actual, instala HAOS en Proxmox siguiendo esta guía y restaura ese backup desde el asistente de bienvenida. En menos de 30 minutos tienes todo migrado sin perder ninguna configuración.
¿Proxmox consume muchos recursos además de la VM de Home Assistant?
Proxmox VE en sí mismo es muy ligero. Con un servidor de bajo consumo, el hipervisor apenas ocupa 512 MB de RAM y una fracción de CPU. El grueso de los recursos va a parar directamente a las VMs que tengas corriendo, en este caso Home Assistant.
Conclusión
Instalar Home Assistant en Proxmox es, probablemente, la decisión más inteligente que puedes tomar si ya tienes un servidor doméstico en marcha. Ganarás en estabilidad, en flexibilidad y, sobre todo, en tranquilidad: con los backups automáticos de Proxmox, tu configuración de domótica está siempre a salvo.
El proceso no es complicado si sigues los pasos con calma. Los puntos más críticos son la configuración de la VM (tipo de máquina q35, BIOS UEFI, CPU tipo host) y desactivar Secure Boot antes del primer arranque real. Con eso bien hecho, el resto fluye solo.
Si tienes alguna duda durante el proceso o te encuentras con un error que no sabes cómo resolver, déjanos un comentario y te ayudamos. Y si esta guía te ha sido útil, echa un vistazo al resto de tutoriales de domótica en tecnocripto.com, donde tienes guías para sacarle todo el partido a Home Assistant una vez lo tengas instalado.