Home Assistant Updates ohne Ausfallstress: Compose-Workflow mit Rollback

Schwierigkeit: Mittel · Dauer: 35–60 Min · Ziel: Home-Assistant-Updates reproduzierbar ausrollen und bei Problemen schnell zurückrollen.

Kurzproblem und Zielbild

Home Assistant wächst schnell mit Integrationen. Unkontrollierte Updates führen oft zu Ausfällen oder kaputten Add-ons. Ziel ist ein klarer Update-Workflow mit Backup, Check und Rollback.

Voraussetzungen

• Home Assistant via Docker Compose
• Persistente Config unter ./config
• Backup-Möglichkeit vor Update

Schnellstart (funktionierende Basis)

cd ~/stacks/homeassistant
tar -czf backup-ha-$(date +%F-%H%M).tar.gz ./config
docker compose pull
docker compose up -d

Schritt-für-Schritt Umsetzung

1) Pre-Update Snapshot

tar -czf backup-ha-$(date +%F-%H%M).tar.gz ./config
cp compose.yml backup-compose-$(date +%F-%H%M).yml

2) Update kontrolliert ausrollen

docker compose pull
docker compose up -d --remove-orphans
docker compose ps

3) Kernfunktionen prüfen

docker compose logs --tail=180 homeassistant
# Login/UI, Automationen, Integrationen testen

4) Rollback bei Fehlern

docker compose down
cp backup-compose-YYYY-MM-DD-HHMM.yml compose.yml
# ggf. config-backup zurückspielen
docker compose up -d

Validierung / Checks

docker compose ps
docker compose logs --tail=200 homeassistant
curl -I http://localhost:8123

Troubleshooting

Container startet, UI bleibt unzuverlässig

docker compose logs homeassistant --tail=250
# fehlerhafte custom components prüfen

Integrationen nach Update fehlerhaft

# letzte stabile Version pinnen und erneut deployen

Fazit

Mit klarer Update-Routine wird Home Assistant deutlich berechenbarer. Nächster Schritt: festen Wartungstermin + Checkliste pro Update einführen.

Quellen

• Home Assistant Docs
• HA Installation Linux
• Docker Compose Docs