Installation

Voraussetzungen

• Home Assistant 2025.4 oder neuer, das opendata.dwd.de über HTTPS erreicht.
• Ein Standort in Deutschland oder nahe seiner Grenze. Was abgedeckt ist, steht unter Gitterzellen-Suche.

Ein Konto oder API-Schlüssel ist nicht nötig.

Wie du installierst, hängt von deiner Version von Home Assistant ab: Ab Home Assistant 2026.11 kommen Community-Integrationen aus dem Marketplace, der eingebaut ist. Davor kamen sie aus HACS, das du selbst installiert hast.

Installation aus dem Marketplace (Home Assistant 2026.11 und neuer)

1. Öffne DWD Precipitation mit diesem Button im Marketplace:

   

   Oder öffne den Marketplace in den Einstellungen und suche nach DWD Precipitation. Beim ersten Öffnen bittet dich der Marketplace, einen Hinweis zu bestätigen: Inhalte der Community werden nicht vom Home-Assistant-Projekt geprüft.

2. Wähle Installieren, prüfe die Version und bestätige.

3. Die Einrichtung öffnet sich von selbst, sobald die Installation fertig ist. Ein Neustart ist nicht nötig. Hast du sie geschlossen, füge die Integration selbst hinzu.

Updates erscheinen in den Einstellungen bei den Updates von Home Assistant selbst, mit den Versionshinweisen. Starte Home Assistant nach einem Update neu; eine Reparatur unter Einstellungen > System > Reparaturen erinnert dich daran und kann den Neustart für dich auslösen. Eine neue Version kann ein paar Stunden brauchen, bis sie dort erscheint, weil der Marketplace den Katalog nur alle paar Stunden nach neuen Versionen fragt.

Von HACS kommend

Hast du DWD Precipitation mit HACS installiert, musst du nichts tun: Wenn Home Assistant 2026.11 zum ersten Mal startet, übernimmt der Marketplace alles, was HACS installiert hat. DWD Precipitation bleibt installiert, behält seine Einstellungen und Entitäten und bekommt weiter Updates.

Installation mit HACS (Home Assistant 2026.10 und älter)

Wenn du HACS noch nicht hast, installiere es zuerst.

1. Öffne DWD Precipitation mit diesem Button in HACS:

   

   Oder öffne HACS und suche nach DWD Precipitation.

2. Wähle Herunterladen.

3. Starte Home Assistant neu.

4. Füge die Integration hinzu.

HACS zeigt eine Benachrichtigung, wenn eine neue Version erschienen ist; aktualisiere von dort und starte Home Assistant danach erneut neu.

Manuelle Installation

1. Lade dwd_precipitation.zip aus der neuesten Version herunter.
2. Lege in deinem Home-Assistant-Konfigurationsverzeichnis den Ordner /config/custom_components/dwd_precipitation/ an und entpacke die ZIP-Datei hinein. Sie enthält keinen eigenen Ordner: Ihre Dateien gehören direkt in diesen Ordner.
3. Starte Home Assistant neu.
4. Füge die Integration hinzu.

Zum Aktualisieren leerst du diesen Ordner und entpackst die ZIP-Datei der neuen Version hinein. Eine manuelle Installation wird nicht automatisch aktualisiert.

Home Assistant neu starten

Nach der Installation mit HACS oder von Hand und nach jedem Update braucht Home Assistant einen Neustart, um den neuen Code zu laden (Einstellungen > System > Neu starten). Nur eine erste Installation aus dem Marketplace kommt ohne aus.

Die Integration hinzufügen

Nutze diesen Button:

Oder füge sie selbst hinzu:

1. Gehe zu Einstellungen > Geräte & Dienste.
2. Wähle Integration hinzufügen und suche nach DWD Precipitation.
3. Gib einen Namen ein und wähle den Standort. Zu beidem siehe Konfiguration.

Die Sensoren füllen sich innerhalb weniger Minuten: Jedes DWD-Produkt wird beim Start einmal abgerufen und danach immer dann, wenn der DWD eine neue Datei veröffentlicht.

Die Integration entfernen

1. Gehe zu Einstellungen > Geräte & Dienste > DWD Precipitation, öffne das Menü des Eintrags und wähle Löschen. Damit werden auch die gespeicherten Daten der Integration gelöscht, etwa die Aufzeichnung der Regenereignisse.
2. Entferne auch den Code:
   • Marketplace: Löschst du den letzten Eintrag, fragt Home Assistant, ob es DWD Precipitation auch deinstallieren soll. Du kannst es auch später auf seiner Seite im Marketplace deinstallieren (Menü mit den drei Punkten). Solange noch ein Eintrag existiert, deinstalliert der Marketplace es nicht, sondern bietet an, den Eintrag zu löschen und dann zu deinstallieren. Hat Home Assistant die Integration noch geladen, bittet dich eine Reparatur um einen Neustart.
   • HACS: Entferne es in HACS und starte Home Assistant neu.
   • Manuelle Installation: Lösche den Ordner custom_components/dwd_precipitation und starte Home Assistant neu.