Home Assistant escucha por defecto en el puerto 8123 (TCP). En tu red local lo abres con http://IP-DEL-EQUIPO:8123 o, en la mayoría de instalaciones, con http://homeassistant.local:8123.
Cómo cambiar el puerto
El puerto se define en configuration.yaml, dentro del bloque http:
http:
server_port: 8123
Cambia el número por el que quieras, guarda el fichero y reinicia Home Assistant (Ajustes > Sistema > Reiniciar). Después tendrás que abrirlo con el puerto nuevo en la URL. Si usas la app móvil, actualiza también la dirección del servidor en sus ajustes.
Acceder desde fuera de casa
Hay dos caminos y no son igual de seguros:
- Sin abrir puertos: un túnel (por ejemplo, Cloudflare Tunnel) o una VPN. Es la opción más segura porque nada de tu red queda escuchando en internet. Lo explicamos en Home Assistant acceso remoto sin abrir puertos.
- Abriendo puertos en el router: redirigir el puerto 443 de tu IP pública al 8123 del equipo, con un dominio y un certificado SSL. Tienes la guía completa en acceso remoto a Home Assistant con HTTPS y IP dinámica.
Por qué no conviene exponer el 8123 tal cual
- Sin HTTPS, tu contraseña viaja sin cifrar.
- Los puertos habituales se escanean constantemente: cualquier servicio abierto recibirá intentos de acceso.
- Es mejor publicar un puerto estándar (443) con certificado válido y mantener Home Assistant al día.
Si pones un proxy inverso delante, Home Assistant necesita saberlo. Añade en configuration.yaml:
http:
use_x_forwarded_for: true
trusted_proxies:
- 192.168.1.10
Sustituye la dirección por la IP del proxy en tu red. Sin esto, Home Assistant rechazará las peticiones que llegan por el proxy.
Y si tu IP cambia
Con una IP pública dinámica, tu dominio tiene que seguir a la IP para que el acceso remoto no se rompa. Puedes hacerlo con un DDNS gratuito; mira la guía de acceso remoto con DuckDNS o usa tu propio dominio en Cloudflare con SyncMyIP.
Si no consigues conectar
- Comprueba el cortafuegos del equipo donde corre Home Assistant.
- Si tu operador usa CGNAT no podrás abrir puertos desde fuera; mira qué es CGNAT y cómo saber si lo tienes y usa un túnel.