# Kurzanleitung — Installation auf einer Home-Assistant-Instanz Ausführliche Erklärungen, Umstieg von der alten Fassung und Troubleshooting stehen in [`../INSTALL.md`](../INSTALL.md) — hier nur die Checkliste. ## Voraussetzungen - Home Assistant 2025.1 oder neuer - Das **Samba-Share-Add-on** in HA läuft, damit `\\\config` vom PC aus erreichbar ist Das war's. Anders als früher braucht es weder HACS noch pyscript, kein Zugriffstoken und keinen `pip install` auf der HA-Maschine. --- ## Der schnelle Weg: `Installieren.cmd` **Doppelklick auf `Installieren.cmd`.** Das Skript sucht die HA-Instanz im Netz (`\\homeassistant\config` und die üblichen Alternativen, sonst fragt es nach dem Pfad) und kopiert einen einzigen Ordner: ``` custom_components\audi_dashboard\ -> \custom_components\ ``` Am Ende listet es auf, was noch von Hand zu tun ist. Erst schauen, was passieren würde, ohne dass etwas geschrieben wird: ```powershell .\install.ps1 -Pruefen ``` Mit festem Ziel: ```powershell .\install.ps1 -Ziel "\\192.168.1.50\config" ``` ### Ist das für meine bestehende HA-Installation gefährlich? Nein — und das lässt sich nachprüfen statt glauben. Die riskanteste Stelle der früheren Fassung ist weg: sie musste Blöcke in die `configuration.yaml` eintragen, und eine kaputte `configuration.yaml` ist der eine Weg, auf dem ein Installer Home Assistant am Starten hindern kann. **Diese Fassung fasst die Datei überhaupt nicht mehr an** — die Integration meldet ihr Panel selbst an, dafür braucht es kein YAML. Was bleibt: - Geschrieben wird **ausschließlich** in `\custom_components\audi_dashboard`. Kein anderer Pfad — nicht `.storage\`, nicht `configuration.yaml`, nicht `automations.yaml`, nicht `www\`, nicht `audi_dashboard\` (die Fahrzeugdaten). - Gelöscht wird nur der eigene Ordner, und auch der nur, wenn darin eine `manifest.json` mit `"domain": "audi_dashboard"` liegt. Ein fremder Ordner unter demselben Namen führt zum Abbruch, nicht zum Löschen. - Nach dem Kopieren liest das Skript die `manifest.json` im Ziel zurück und prüft die Version. Stimmt sie nicht, bricht es mit einer Meldung ab, statt eine halbe Installation stehen zu lassen. - Es **startet HA nicht neu**. Bis zum manuellen Neustart ändert sich am laufenden Betrieb nichts. Ein zweiter Lauf auf einer laufenden Installation ist damit gefahrlos — er ist sogar der vorgesehene Weg für Updates. Der einzige Punkt, der einer sonst gesunden Installation gefährlich werden kann, ist **nicht** der Installer, sondern die Datenaufbewahrung aus Schritt 3 unten: ein Jahr Fahrzeugverlauf braucht grob 1–1,5 GB. Auf HA OS mit SD-Karte oder kleiner eMMC vorher unter **Einstellungen → System → Speicher** nachsehen; ist der Datenträger voll, startet HA nicht mehr — unabhängig von dieser App. --- ## Der Weg von Hand Falls `Installieren.cmd` nicht durchläuft oder lieber nachvollziehbar: Den Ordner `custom_components\audi_dashboard` aus dem Projekt nach `\custom_components\` kopieren. Ist dort schon eine ältere Fassung, diese vorher komplett löschen — bleibt eine Datei liegen, die es im neuen Stand nicht mehr gibt, lädt Home Assistant sie trotzdem mit. --- ## Danach ### 1. Home Assistant neu starten **Einstellungen → System → Neu starten.** Beim ersten Start lädt HA die Abhängigkeit `pypdf` nach (für die Tankbelege) — das kann eine Minute dauern. ### 2. Integration hinzufügen **Einstellungen → Geräte & Dienste → Integration hinzufügen → Audi Dashboard.** Es gibt nichts einzugeben. Danach steht **Mein Audi** in der Seitenleiste. ### 3. Datenaufbewahrung — zeitkritisch Den Block aus [`recorder_snippet.yaml`](recorder_snippet.yaml) in die `configuration.yaml` übernehmen. Home Assistant löscht Sensor-Verläufe sonst nach 10 Tagen; was weg ist, lässt sich auch mit „Daten importieren aus Home Assistant" nicht mehr nachtragen. Je früher der Block drin ist, desto mehr Vergangenheit bleibt erhalten. Vorher den Speicher prüfen (siehe oben). Bei knappem Platz mit `purge_keep_days: 90` anfangen — Details im Kopf der Datei. Bewusst nicht vom Installer erledigt: das ist eine Entscheidung über den Plattenplatz der Instanz, und viele Instanzen haben schon einen eigenen `recorder:`-Block, den man zusammenführen muss statt zu überschreiben. ### 4. Sensoren zuordnen In der App: **Einstellungen → Fahrzeug einrichten → Setup.** Im Auslieferstand ist **kein** Sensor vorbelegt — das ist Absicht, siehe `../INSTALL.md`. Zwingend ist allein der Zündungs-/ACC-Sensor (`binary_sensor`, meist vom Teltonika FMM003): er trägt die Fahrterkennung. Änderungen wirken sofort, ein Neustart ist dafür nicht mehr nötig. ### 5. Fahrzeugdaten eintragen **Einstellungen → Fahrzeug einrichten.** Das Profil ist bereits da — die Integration hat es beim ersten Start aus ihrer Vorlage angelegt. Zu ersetzen sind die Platzhalter: VIN, Kennzeichen, Erstzulassung, HU-Termin, Versicherung, Werkstatt, Servicebuch. ### 6. Vergangenes nachholen (optional) **Einstellungen → Einrichten → Daten importieren aus Home Assistant** holt Fahrten, Tankvorgänge und Spannungswerte aus dem bereits aufgezeichneten HA-Verlauf nach. --- ## Updates Denselben Aufruf noch einmal — `Installieren.cmd` oder `install.ps1`. Der Ordner wird ersetzt, die Fahrzeugdaten unter `audi_dashboard\` und die eigenen Fotos unter `www\bilder\` bleiben unangetastet. Danach HA neu starten (oder kürzer: **Einstellungen → Geräte & Dienste → Audi Dashboard → Neu laden**). HACS ist hier bewusst keine Alternative: es kann laut eigener Dokumentation grundsätzlich nicht mit privaten GitHub-Repositories arbeiten, und das Repository ist privat, weil es lizenzierte Audi-Assets enthält.