Tras actualizar Home Assistant a la versión 2026.07, puede aparecer un aviso sobre la retirada de la configuración SMTP en YAML. Si usas correos electrónicos para alertas, recordatorios o notificaciones de tus automatizaciones, conviene atenderlo antes de borrar nada.
La buena noticia es que Home Assistant ya puede importar esa configuración a su nueva integración gráfica de SMTP. Solo hay que comprobar que la migración se ha realizado bien, limpiar el YAML antiguo y probar el envío de mensajes.
Qué significa el aviso SMTP después de actualizar
Home Assistant lleva tiempo trasladando varias configuraciones que antes se escribían manualmente en archivos YAML hacia la interfaz gráfica. El objetivo es que muchas integraciones puedan configurarse, revisarse y mantenerse desde Ajustes, sin depender tanto de editar archivos de texto.
En Home Assistant 2026.07 le toca el turno a SMTP, el sistema que permite enviar correos electrónicos desde la instalación. Este servicio suele estar presente en automatizaciones que avisan de una alarma, de una puerta abierta, de una incidencia técnica o de cualquier evento que quieras recibir en una dirección de correo.
El aviso indica que la configuración SMTP escrita en YAML dejará de estar disponible en futuras versiones. La fecha importante es la versión 2027.1, por lo que no conviene ignorar el mensaje aunque los correos sigan funcionando hoy.
El aviso no significa que tu correo haya dejado de funcionar. Indica que debes eliminar la configuración antigua de YAML después de confirmar que Home Assistant ha importado sus datos a la integración SMTP.
La migración se produce de forma automática al actualizar. Home Assistant detecta la configuración SMTP que ya tenías definida y crea una integración llamada SMTP dentro de Dispositivos y servicios. Por eso, en muchos casos no hace falta volver a introducir el servidor, las credenciales ni los destinatarios.
Esto es especialmente útil en instalaciones donde una misma cuenta de correo actúa como remitente para toda la vivienda. Por ejemplo, puede existir una dirección dedicada a la casa, distinta de las cuentas personales de quienes viven en ella. Esa cuenta común puede enviar avisos a dos, tres o más destinatarios personales según la automatización que se ejecute.
Si tenías varios destinatarios definidos en YAML, la nueva integración puede mostrar varias configuraciones o grupos. No significa que se hayan creado varios remitentes. El remitente puede seguir siendo el mismo correo de la casa, mientras que cada grupo corresponde a una dirección distinta que recibe las notificaciones.
Comprueba que Home Assistant ha importado la integración SMTP
Antes de modificar un archivo YAML, hay que confirmar que la integración nueva existe y contiene la configuración esperada. Este paso evita borrar una definición que todavía no se ha trasladado correctamente.
En la interfaz de Home Assistant, sigue esta ruta:
- Entra en Ajustes.
- Abre Dispositivos y servicios.
- Usa el buscador e introduce «SMTP».
- Localiza la integración llamada SMTP.
Si aparece esa integración, Home Assistant ha detectado e importado la configuración anterior. Al abrirla, podrás revisar los elementos creados a partir de los destinatarios que tenías configurados.
| Configuración anterior en YAML | Resultado esperado tras la actualización |
|---|---|
| Una cuenta de correo remitente | La misma cuenta sigue enviando las notificaciones |
| Un destinatario | Un grupo o configuración de destino en SMTP |
| Varios destinatarios | Varios grupos o destinos dentro de la integración |
| Automatizaciones con correo | Las acciones de envío siguen disponibles para probarlas |
La presencia de varios bloques suele generar dudas. Sin embargo, es normal que la integración diferencie las direcciones que reciben los mensajes. Si tu instalación envía desde una cuenta común a tu correo y al de otra persona, es lógico ver dos destinos, aunque ambos mensajes salgan desde el mismo remitente.
Revisa que los destinatarios coincidan con los que usabas antes. También conviene abrir alguna automatización que envíe correo y fijarse en qué destino utiliza. No hace falta cambiar las automatizaciones si la importación se ha realizado correctamente, pero esta revisión te ayuda a detectar una dirección ausente antes de eliminar el YAML.
Si no ves la integración SMTP, o si falta algún destinatario que usabas, no borres todavía nada. Mantén la configuración existente y revisa la actualización de Home Assistant antes de reiniciar el sistema.
Elimina la configuración SMTP antigua del YAML
Una vez confirmada la integración SMTP, ya puedes retirar las líneas antiguas del YAML. El aviso aparece porque Home Assistant sigue encontrando esa definición manual, aunque la nueva integración ya tenga los datos importados.
La ubicación depende de cómo hayas organizado tu instalación. Algunas configuraciones guardan todo dentro de configuration.yaml. Otras separan los componentes en varios archivos, algo habitual cuando el archivo principal ya tiene muchas automatizaciones, scripts y notificaciones.
Por ejemplo, las notificaciones por correo pueden estar en un archivo dedicado como notify.yaml, incluido desde el archivo de configuración principal. En ese caso, la definición SMTP no aparecerá en configuration.yaml, sino en el archivo específico de notificaciones.
Abre el editor que uses habitualmente, como File Editor, y busca las líneas relacionadas con SMTP. Debes eliminar la configuración antigua completa, no una parte aislada. Conserva el resto de servicios de notificación que no dependan del correo, como las notificaciones push al móvil.
El proceso puede resumirse así:
- Abre
configuration.yamly revisa si incluye la configuración SMTP. - Si usas archivos separados, abre el archivo de notificaciones, como
notify.yaml. - Localiza el bloque que define el servicio SMTP antiguo.
- Elimina todo ese bloque de configuración.
- Guarda el archivo antes de reiniciar Home Assistant.
No hace falta reescribir el servidor de correo en la interfaz si Home Assistant ya ha creado la integración automáticamente. La tarea consiste en retirar el duplicado antiguo para que el sistema deje de mostrar el aviso de deprecación.
Borra el YAML solo después de comprobar que la integración SMTP aparece en Ajustes > Dispositivos y servicios y que contiene los destinatarios que esperabas encontrar.
Este orden importa porque la configuración YAML era la referencia anterior. Si la eliminas antes de validar la importación, podrías perder una pista útil para comprobar servidores, direcciones de destino o parámetros que necesitaras recuperar.
Reinicia Home Assistant para aplicar los cambios
Guardar el archivo no elimina el aviso de inmediato. Home Assistant necesita reiniciarse para cargar la configuración actualizada y dejar de detectar las líneas SMTP que acabas de retirar.
Ve a Ajustes > Sistema y abre las opciones de reinicio. Un reinicio de Home Assistant es suficiente para aplicar el cambio. También puedes reiniciar el sistema completo si te conviene hacerlo, por ejemplo, si hace tiempo que no reinicias la máquina donde ejecutas Home Assistant.
Al volver a entrar, revisa el área de configuración. Si todo ha ido bien, el aviso sobre SMTP ya no debería aparecer. Eso indica que Home Assistant ha dejado de encontrar la definición YAML obsoleta y ahora usa la integración importada.
El reinicio no sustituye la prueba real de envío. Que el aviso desaparezca confirma que has limpiado la configuración, pero aún falta verificar que el correo llega correctamente.
Abre una automatización o un script que ya envíe una notificación por email. Es preferible utilizar una acción existente, porque así pruebas una configuración que ya conocías y puedes comparar el resultado con los mensajes que recibías antes.
En el editor de la automatización, localiza la acción de notificación por correo y pulsa Ejecutar acción. Home Assistant debería indicar que la ejecución se ha realizado correctamente. Después, revisa la bandeja de entrada del destinatario.
La comprobación ideal incluye estos puntos:
- El correo llega a la dirección correcta.
- El remitente sigue siendo la cuenta habitual.
- El asunto conserva el contenido esperado.
- El cuerpo del mensaje se muestra completo.
- La notificación no tarda más de lo habitual en llegar.
Si tienes más de un destinatario configurado, repite la prueba con una automatización o script que escriba a cada uno de ellos. Así validarás que todos los destinos importados por la integración SMTP funcionan y no solo el primero que has probado.
Mantén ordenadas tus notificaciones por correo
El cambio a la integración SMTP no obliga a abandonar las automatizaciones por correo. Tus avisos pueden seguir siendo igual de útiles para incidencias que requieren una notificación más detallada que un mensaje push.
Una automatización puede continuar enviando una alerta al móvil y, al mismo tiempo, un email con información adicional. Por ejemplo, una notificación push puede avisarte de que se ha activado un sensor, mientras que el correo puede incluir un asunto identificable y un mensaje más completo para consultarlo después.
Separar la cuenta de correo de la vivienda de las cuentas personales también puede ayudar a mantener organizados los servicios domésticos. Esa dirección común puede utilizarse en dispositivos compartidos, televisores, plataformas de streaming y sistemas de domótica, mientras que las alertas se envían a los correos personales de cada destinatario.
La migración de SMTP es una buena ocasión para revisar qué automatizaciones siguen usando el email. Quizá hay mensajes que ya no necesitas, destinatarios que han cambiado o alertas duplicadas entre el móvil y el correo. No es necesario modificar nada para resolver el aviso, pero revisar esos flujos puede evitar notificaciones innecesarias.
También conviene conservar una estructura clara en los archivos YAML que aún uses. Aunque Home Assistant esté trasladando más configuraciones a la interfaz, YAML sigue siendo habitual para automatizaciones complejas, paquetes y elementos que prefieras administrar como archivos.
Para compartir dudas, experiencias y soluciones con otros usuarios, puedes unirte a la comunidad de Telegram de Javier Gutiérrez Abella. También hay tutoriales, artículos y una sección de ofertas en el foro de SpyFly, donde se publican cupones de AliExpress con descuentos que pueden llegar a 40 € según el importe de la compra.
Un aviso menos y una instalación preparada para 2027.1
La solución del aviso SMTP en Home Assistant 2026.07 consiste en respetar un orden sencillo: comprobar la integración nueva, borrar el bloque SMTP antiguo del YAML, reiniciar y probar un correo real.
Después de esa comprobación, tus automatizaciones seguirán enviando mensajes con el remitente, destinatario, asunto y contenido habituales. Además, tu instalación quedará preparada para la eliminación definitiva de esta configuración YAML en Home Assistant 2027.1.
