Document Authelia without Redis session backend

Document Authelia without Redis session backend

docs/HOME_ASSISTANT_INFLUXDB_ECOWITT.md

@@ -2,6 +2,15 @@
 
 Ziel: Home Assistant schreibt ausgewaehlte Ecowitt- und Energiesensoren nach InfluxDB 3 Core. Grafana bleibt das Langzeit-Dashboard, Home Assistant bleibt die Automationszentrale.
 
+## Live-Stand 2026-05-04
+
+- Home Assistant ist per SSH unter `192.168.178.50:22222` erreichbar.
+- `ha core check` ist erfolgreich.
+- InfluxDB 3 Core ist von Home Assistant aus unter `http://192.168.178.58:8181/` erreichbar; `401 Unauthorized` ohne Token ist der erwartete Reachability-Test.
+- In `/homeassistant/configuration.yaml` ist noch kein `influxdb:`-Block aktiv.
+- In `/homeassistant/secrets.yaml` ist noch kein `influxdb3_homeassistant_token` eingetragen.
+- In der Home-Assistant-Entity-Registry ist noch keine Ecowitt-Integration sichtbar; aktuell existiert nur `weather.forecast_home`.
+
 ## 1. InfluxDB fuer Home Assistant erreichbar machen
 
 Der Stack haelt InfluxDB bewusst ohne Traefik-Route. Fuer Home Assistant wird nur der HTTP-Port `8181` auf einer internen LAN-Adresse veroeffentlicht.
@@ -9,29 +18,46 @@ Der Stack haelt InfluxDB bewusst ohne Traefik-Route. Fuer Home Assistant wird nu
 In Komodo/Stack-Environment fuer `ops/grafana-influxdb` setzen:
 
 ```env
-INFLUXDB_BIND_IP=192.168.178.X
+INFLUXDB_BIND_IP=192.168.178.58
 ```
 
-`192.168.178.X` ist die LAN-IP des Docker-Hosts, auf dem `influxdb3-core` laeuft. Nicht `0.0.0.0` verwenden, wenn es nicht notwendig ist.
+`192.168.178.58` ist die LAN-IP des Docker-Hosts, auf dem `influxdb3-core` laeuft. Nicht `0.0.0.0` verwenden, wenn es nicht notwendig ist.
 
 Danach den Stack neu deployen und von Home Assistant aus pruefen:
 
 ```bash
-curl -I http://192.168.178.X:8181/health
+curl -i --max-time 5 http://192.168.178.58:8181/
 ```
 
+Erwartetes Ergebnis ohne Token: `401 Unauthorized`. Das bestaetigt, dass der LAN-Port erreichbar ist und Authentifizierung aktiv bleibt.
+
 ## 2. Token fuer Home Assistant
 
-Am besten einen eigenen Write-Token fuer Home Assistant verwenden. Fuer den ersten Test kann der bestehende Admin-Token funktionieren; langfristig sollte der HA-Token nur in die Datenbank `homelab` schreiben duerfen.
+InfluxDB 3 Core unterstuetzt aktuell Admin- und Named-Admin-Tokens. Einen eigenen Named-Admin-Token fuer Home Assistant verwenden, damit der Token getrennt vom initialen Operator-/Admin-Token rotiert werden kann.
 
 Den Token in Home Assistant eintragen:
 
 ```yaml
 # /homeassistant/secrets.yaml
-influxdb3_homeassistant_token: "apiv3_REPLACE_WITH_WRITE_TOKEN"
+influxdb3_homeassistant_token: "apiv3_REPLACE_WITH_HOME_ASSISTANT_TOKEN"
 ```
 
-## 3. Home Assistant konfigurieren
+Token niemals ins Git-Repository schreiben.
+
+## 3. Ecowitt in Home Assistant anbinden
+
+Die offizielle Ecowitt-Integration ist eine lokale Push-Integration. Home Assistant erzeugt einen HTTP-Webhook; die Wetterstation sendet danach ihre Daten aktiv an Home Assistant.
+
+1. In Home Assistant `Einstellungen -> Geraete & Dienste -> Integration hinzufuegen -> Ecowitt` oeffnen.
+2. Die angezeigten Werte fuer Server/IP, Pfad und Port notieren.
+3. Im Ecowitt-Gateway entweder per App oder Web-UI unter `Weather Services -> Customized` eintragen:
+   - Customized: `Enable`
+   - Protocol Type Same As: `Ecowitt`
+   - Server/IP, Path und Port exakt wie in Home Assistant angezeigt
+4. Wichtig: Ecowitt kann kein HTTPS. Den lokalen HTTP-Endpunkt von Home Assistant verwenden, nicht eine reine HTTPS-/Traefik-URL.
+5. Nach dem ersten Push pruefen, ob neue `sensor.*`- und ggf. `binary_sensor.*`-Entities in Home Assistant auftauchen.
+
+## 4. Home Assistant fuer InfluxDB konfigurieren
 
 Minimaler Startblock fuer `/homeassistant/configuration.yaml`:
 
@@ -39,7 +65,7 @@ Minimaler Startblock fuer `/homeassistant/configuration.yaml`:
 influxdb:
   api_version: 2
   ssl: false
-  host: 192.168.178.X
+  host: 192.168.178.58
   port: 8181
   token: !secret influxdb3_homeassistant_token
   organization: homelab
@@ -60,7 +86,7 @@ influxdb:
       - sensor.wallbox_energie_heute
 ```
 
-Die `sensor.*gw*`-Regel ist nur ein Startpunkt, weil Ecowitt-Gateways haeufig `gw...` im Entity-Namen haben. Nach dem ersten Export in Grafana pruefen und die Liste enger machen.
+Die `sensor.*ecowitt*`- und `sensor.*gw*`-Regeln sind nur Startpunkte. Nach dem ersten Ecowitt-Push die echten Entity-IDs aus Home Assistant auslesen und die Liste enger machen.
 
 Nach dem Edit:
 
@@ -69,7 +95,7 @@ ha core check
 ha core restart
 ```
 
-## 4. Grafana Smoke-Test
+## 5. Grafana Smoke-Test
 
 In Grafana mit der bestehenden Datenquelle `InfluxDB 3 Core` eine SQL-Abfrage testen:
 
@@ -88,7 +114,7 @@ ORDER BY time DESC
 LIMIT 20
 ```
 
-## 5. Dashboard-Kandidaten
+## 6. Dashboard-Kandidaten
 
 Sinnvolle Panels fuer das erste Wetter-Dashboard:
 
@@ -101,7 +127,7 @@ Sinnvolle Panels fuer das erste Wetter-Dashboard:
 - PV-Ueberschuss vs. Wetter
 - Wallbox-Leistung vs. PV-Ueberschuss
 
-## 6. Erste Automationen
+## 7. Erste Automationen
 
 Home Assistant bleibt fuer Reaktionen zustaendig: