Saltar a contenido

Source: Mastering Home Assistant Updates and Rollbacks

Guía operativa para hacer upgrades de Home Assistant con un plan de rollback explícito. Define los cuatro componentes (Core, Supervisor, HAOS, Add-ons), los tres channels (stable/beta/dev), una pre-update checklist de 5 pasos, el orden recomendado de update y dos procedimientos de rollback (full restore vs CLI core-only).

Metadatos

  • Tipo: blog post (newerest.space) por "NGC 224 / DIY Smart Home Creator".
  • Fecha: ~2025-05 (aproximada por "a year ago"; corregir cuando se confirme).
  • Lectura: 5 min.

Por qué entró al wiki

  • Es el primer source de methodology operativa para Q2 (upgrade reliability) — antes que ejemplos de fallos.
  • Documenta el ha CLI con ha core update --version <X> — una herramienta concreta para rollback parcial.
  • Establece la pre-update checklist que el wiki va a tratar como base; las contribuciones futuras la pueden refinar pero no empezar de cero.

Páginas derivadas

Resumen del contenido

  • 4 componentes: Core (logic + integrations, monthly), Supervisor (gestor Core/Add-ons/OS, infrequent), HAOS (Linux subyacente, periodic), Add-ons (apps separadas tipo Z2M / Mosquitto).
  • 3 channels: stable, beta, dev.
  • Pre-update (5 pasos): (1) leer release notes y breaking changes, (2) verificar compatibilidad de integrations custom + hardware, (3) full backup verificado, (4) "Check Configuration" en Developer Tools → YAML, (5) plan de rollback escrito.
  • Orden recomendado: Core → Supervisor → OS → Add-ons.
  • Post-update: revisar Logs por ERROR/WARNING, manualmente operar dispositivos críticos + triggers, verificar Integrations.
  • Rollback:
  • Full restore desde Settings → System → Backups (recomendado para fallos mayores).
  • Core-only: ha core update --version <previous> (no toca Supervisor, OS, Add-ons).
  • Best practices: no ser primero (esperar ~1 semana después de un release mayor), update incremental, suscribirse a announcement channels, mantener notas de cambios significativos.

Citas textuales

  • "Read the release notes and specifically check the 'Breaking Changes' section for the version you're updating to."

  • "This only reverts the Core, not the Supervisor, OS, or Add-ons, so it might not fix issues caused by other component updates." (sobre rollback core-only)

  • "Approaching Home Assistant updates with a strategy of preparation, careful execution, and a clear rollback plan transforms them from a potential headache into a routine maintenance task."

Abierto / gaps

  • ¿El procedimiento de rollback es válido en HA Container también (donde ha CLI no existe igual)? Hay que documentar el equivalente Docker Compose.
  • ¿"Google Drive Backup add-on" sigue existiendo en 2026 post-deprecation del modelo Supervised? Verificar.
  • ¿Cuál es el tiempo realista entre release de una .0 y cuando llegan los hotfixes que justifican el "wait a week"? Cruzar contra changelogs 2026.1–2026.5.
  • ¿Cómo se automatizan estos pasos con un agente (Claude Code) — pre-update checklist como script bash + post-update smoke test? Apunte para iteraciones de Q10.