Add, Installation, Home Assistant and Proxmox DE/EN / Integration HA update

docs/installation/configuration.mdx

@@ -0,0 +1,208 @@
+---
+sidebar_position: 10
+---
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
+
+# Konfiguration
+
+:::note
+Diese Konfigurations-Anleitung beschreibt beide möglichen Wege eine funktionierende Konfigurationsdatei zu erstellen, mit oder ohne Konfigurationsassistenten.
+Wobei ersteres nur  bei nicht Docker basierten Systemen möglich ist.
+:::
+
+
+## Konfiguration mit Assistenten
+
+Dieser Teil der Anleitung richtet sich an Benutzer, die evcc als als Linux/Mac oder Windows Installation nutzen.
+
+- Starte die Konfiguration und folge den Anweisungen im Terminal Fenster:
+
+  ```sh
+  evcc configure
+  ```
+
+  Sofern alle Geräte korrekt konfiguriert sind, kannst du mit den nächsten Schritten fortfahren.
+
+  :::note
+  Fortgeschrittene Anwender (z.B. mit evcc Erfahrung oder technischem Know-How) können auch alternativ folgenden Aufruf verwenden:
+
+  ```sh
+  evcc configure --advanced
+  ```
+
+  Dieser Modus bietet weitere (technisch fortgeschrittene) Einstellmöglichkeiten.
+  :::
+
+- Teste, ob die Konfiguration funktioniert
+
+  ```sh
+  evcc -c evcc.yaml
+  ```
+
+  Öffne einen Browser und gib die folgende URL ein: `http://localhost:7070`. Die evcc Oberfläche sollte nun mit den eigenen Geräten zu sehen sein.
+
+- Wenn alles funktioniert, beende evcc durch drücken der Tastenkombination `CTRL-C`.
+
+- Verschiebe die erstellte Konfigurationsdatei in den Zielordner:
+
+  ```sh
+  sudo mv evcc.yaml /etc
+  ```
+
+- Starte den evcc-Server:
+
+  ```sh title="Linux"
+  sudo systemctl start evcc
+  ```
+
+  ```sh title="MacOS"
+  brew services start evcc
+  ```
+
+  Andere mögliche Befehle sind ... restart evcc und ... stop evcc.
+
+
+
+- Gehe zurück zum Browser und lade die evcc Seite neu. Die Oberfläche sollte nun mit deinen konfigurierten Geräten zu sehen sein.
+
+
+
+## Konfiguration ohne Assistenten
+
+:::note
+Dieser Teil der Anleitung richtet sich an Benutzer, die evcc als Home Assistant Addon oder als Docker Container verwenden und deshalb
+den Konfigurationsassistenten nicht verwenden können.
+Die Anleitung enthält aber eventuell nützliche Tipps, für Personen die ihre Konfiguration, nach der Verwendung des Konfigurationsassistenten noch anpassen müssen.
+:::
+
+Es wird im folgenden davon ausgegangen dass du eine leere Konfigurationsdatei _evcc.yaml_ im korrekten Verzeichnis erstellt hast.
+Die Anleitung findest du in der jeweiligen Installationsanleitung für Docker oder Home Assistant.
+
+```sh
+- config_file Docker:  `/etc/evcc.yaml`
+- config_file Home Assistant: `/config/evcc.yaml`
+```
+
+Kopiere den Inhalt der folgenden minimalen Template Vorlage in deine soeben erstellte Datei _evcc.yaml_.
+Die Vorlage erstellt eine Standardkonfiguration mit statischen Demo-Entitäten.
+
+```yaml title="evcc.yaml Mini Template"
+## Configuration template with demo entities (meters, chargers) ##
+
+# log settings
+log: info
+levels:
+  site: debug
+  lp-1: debug
+  lp-2: debug
+  cache: error
+  db: error
+
+# meter definitions
+# name can be freely chosen and is used as reference when assigning meters to site and loadpoints
+# for documentation see https://docs.evcc.io/docs/devices/meters
+meters:
+  # replace with your real grid meter
+  - name: my_grid
+    type: template
+    template: demo-meter
+    usage: grid
+    power: -1000 # 1 kW feed-in
+  # replace with your real pv system
+  - name: my_pv
+    type: template
+    template: demo-meter
+    usage: pv
+    power: 4000 # 4 kW production
+  # replace with your real battery
+  - name: my_battery
+    type: template
+    template: demo-battery
+    usage: battery
+    power: -1000 # 1 kW battery charging
+    soc: 50 # 50 % state of charge
+
+# replace with your real charger
+# see https://docs.evcc.io/docs/devices/chargers
+chargers:
+  - name: my_charger
+    type: template
+    template: demo-charger
+    status: C # charging
+    power: 2000 # 2 kW charging power
+    enabled: true # optional
+
+# replace with your real vehicle (optional)
+# see https://docs.evcc.io/docs/devices/vehicles
+vehicles:
+  - name: my_car
+    type: template
+    template: offline
+    title: blue e-Golf
+    capacity: 50 # in kWh
+
+# assign your devices to the site
+site:
+  title: Home # display name for UI
+  meters:
+    grid: my_grid
+    pv:
+      - my_pv
+    battery:
+      - my_battery
+
+# define your loadpoints according your needs
+# see https://docs.evcc.io/en/docs/reference/configuration/loadpoints
+loadpoints:
+  - title: Garage # display name for UI
+    charger: my_charger # charger
+    vehicle: my_car # default vehicle
+
+# enter your real grid tariff and feed-in price
+# see https://docs.evcc.io/docs/devices/tariffs
+tariffs:
+  currency: EUR
+  grid:
+    type: fixed
+    price: 0.29 # EUR/kWh
+  feedin:
+    type: fixed
+    price: 0.10 # EUR/kWh
+```
+
+
+Wenn du stattdessen sehen willst, wie evcc in einer dynamischen Demo läuft,
+kopiere den Inhalt von https://github.com/evcc-io/evcc/blob/master/cmd/demo.yaml in deine _evcc.yaml_ Datei.
+
+
+- Jetzt kannst du loslegen und das Addon oder den Docker Container starten.
+- Überprüfe die Installation, indem du das WebUI öffnest - du solltest nun das evcc-Webinterface in einem statischen Demo-Modus sehen.
+- Wenn dies ok ist, kannst du die Datei _evcc.yaml_ bearbeiten und dein eigenes Setup erstellen (nur mit der statischen Vorlage möglich).
+- Kopiere dazu die nötigen Templates die du in der Dokumenation im Abschnitt [Geräte, z.b. Wallboxen](../devices/chargers) findest.
+
+:::tip
+Wenn du mit der manuellen Konfiguration nicht zurechtkommst, solltest du ein eigenständiges evcc Windows- oder Linux-System installieren
+ und den Konfigurationsassistenten verwenden.
+
+Der Konfigurationsassistent ist in der Home Assistant-Umgebung nicht verfügbar.
+
+Es ist einfacher, dort `evcc configure` zu verwenden und dann die erzeugte _evcc.yaml_ auf das gewünschte System zu kopieren.
+
+**Fortgeschrittene Benutzer** (mit evcc-Erfahrung und etwas technischem Know-how) sollten den erweiterten Konfigurator verwenden:
+:::
+
+Die minimale Template Vorlage enthält nur die nötigsten Abschnitte der Konfiguration.
+
+Falls du nicht aufgeführte Strukturen oder Erklärungen benötigst, lohnt sich ein Blick in die vollausgebaute Vorlage unter diesem
+Link https://github.com/evcc-io/evcc/blob/master/evcc.dist.yaml.
+
+- Teste jedes neu hinzugefügte Gerät, um sicherzustellen, dass deine neue Konfiguration funktioniert.
+- Sobald alle Geräte konfiguriert sind, kannst du mit der Einrichtung über die Benutzeroberfläche fortfahren.
+
+:::tip
+Für Nutzer von Home Assistant
+
+Fahre mit der Installation der evcc-Integration für Home Assistant fort, wie in diesem Abschnitt [Integrationen](../integrations/home-assistant) beschrieben.
+:::
+

docs/installation/docker.mdx

@@ -30,7 +30,13 @@ Diese Dokumentation ist für Docker und Synology. Bei Verwendung anderer Systeme
 
 ## Konfiguration
 
-1. Es wird eine **funktionierende** evcc Konfiguration benötigt. Führe dazu die Schritte auf einem der folgende Systeme durch:
+1. Es wird eine **funktionierende** evcc Konfiguration benötigt. Es gibt dabei zwei Möglichkeiten:
+   Entweder du folgst der [Anleitung](./configuration#konfiguration-ohne-assistenten) zur Erstellung einer manuellen Konfiguration oder du benutzt den
+   Konfigurationsassistenten und folgst dieser [Anleitung](./configuration#konfiguration-mit-assistenten).
+
+   Für den Weg mit dem Konfigurationsassistenten benötigst du eine zweite Installation von evcc.
+
+   Führe dazu die Schritte auf einem der folgende Systeme durch:
 
    - [Debian, Ubuntu, Raspberry Pi](linux)
    - [macOS](macos)

docs/installation/home-assistant.mdx

@@ -0,0 +1,57 @@
+---
+sidebar_position: 7
+---
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
+import Screenshot from "../../src/components/Screenshot";
+
+# Home Assistant Addon
+
+:::note
+Das evcc Home Assistant Addon ist eine Community Integration und wird "noch" nicht offiziell von den evcc Maintainern unterstützt.
+Der Grund dafür ist, dass im Fehlerfall wichtige Daten nicht einfach bereit gestellt werden können (fehlende evcc cli).
+:::
+
+Diese Anleitung richtet sich an Benutzer, die Home Assistant verwenden und evcc als Addon verwenden möchten. Es ist selbstverständlich auch möglich,
+evcc außerhalb von Home Assistant zu betreiben und auch in Home Assistant zu integrieren. Der Betrieb von evcc als Addon ist natürlich
+der einfachere Weg, hat aber vorderhand den Nachteil, dass man den Konfiguration Assistenten nicht nutzen kann.
+
+Anmerkung: Das Addon benötigt sehr wenig Ressourcen.
+
+## Installations Anleitung
+
+1. Klicke auf -> Add-on Store unter Einstellungen - Addons.
+2. Klicke auf -> drei Punkte -> Repositories.
+3. Kopiere https://github.com/evcc-io/hassio-addon Klicke -> Hinzufügen
+4. Lade die Website neu (CTRL+R oder CTRL+F5 oder CTRL+Fn+F5)
+5. Suche das Add-on „evcc“ und klicke es an.
+6. Klick auf die Schaltfläche „INSTALLIEREN“.
+
+### Konfigurationsdatei
+
+Gehe im „evcc“ Addon in das Menü Information und aktiviere „in der Seitenleiste anzeigen“ (evcc UI http://your-ha-instance-ip-address:7070)
+
+Gehe zum Menü „Konfiguration“ und wähle dein Arbeitsverzeichnis aus (Beispiel):
+
+![Image](screenshots/ha_configuration_ui.webp)
+
+```sh
+- config_file: /config/evcc.yaml
+- sqlite_file: /data/evcc.db
+```
+
+Lasse den Abschnitt Netzwerk unverändert.
+
+Erstelle eine evcc-Konfigurationsdatei _evcc.yaml_ in deinem Home Assistant-Stammkonfigurationsordner (/homeassistant).
+
+## Konfiguration
+
+Folge nun dieser Anleitung um die evcc-Konfigurationsdatei mit einem Template Inhalt zu befüllen [Konfiguration (manuell)](./configuration#konfiguration-ohne-assistenten)
+
+## Installation der evcc-Integration
+
+Wenn du dann deine Konfiguration abgeschlossen hast, kannst mit der Installation der EVCC-Integration für Home Assistant fortfahren, wie in diesem Abschnitt [Integrationen](../integrations/home-assistant) beschrieben.
+
+## Upgrades
+
+Die Aktualisierung auf die neueste Version von evcc ist in den Home Assistant Update-Prozess integriert.

docs/installation/index.md

@@ -10,3 +10,6 @@ Die Erstinstallation von evcc erfordert aktuell noch etwas Fachwissen. Du sollte
 - [macOS](./installation/macos)
 - [Docker, Synology](./installation/docker)
 - [Manuelle Installation (inkl. Windows)](./installation/manual)
+- [Home Assistant addon](./installation/home-assistant)
+- [Proxmox](./installation/proxmox)
+- [Konfiguration (manuell)](./installation/configuration)

docs/installation/linux.mdx

@@ -74,52 +74,6 @@ Cloudsmith ist ein Service, welcher die Entwicklung von Software und Dienstleist
   sudo systemctl stop evcc
   ```
 
-- Starte die Konfiguration und folge den Anweisungen im Terminal Fenster:
-
-  ```sh
-  evcc configure
-  ```
-
-  Sofern alle Geräte korrekt konfiguriert sind, kannst du mit den nächsten Schritten fortfahren.
-
-  :::tip
-  Unter Homeassist ist `configure` nicht möglich. Hier bietet es sich an, evcc auf Windows/Mac zu installieren, dort `evcc configure` auszuführen und die so erstellte evcc.yaml zu kopieren.
-  :::
-
-  :::note
-  Fortgeschrittene Anwender (z.B. mit evcc Erfahrung oder technischem Know-How) können auch alternativ folgenden Aufruf verwenden:
-
-  ```sh
-  evcc configure --advanced
-  ```
-
-  Dieser Modus bietet weitere (technisch fortgeschrittene) Einstellmöglichkeiten.
-  :::
-
-- Teste, ob die Konfiguration funktioniert
-
-  ```sh
-  evcc -c evcc.yaml
-  ```
-
-  Öffne einen Browser und gib die folgende URL ein: `http://localhost:7070`. Die evcc Oberfläche sollte nun mit den eigenen Geräten zu sehen sein.
-
-- Wenn alles funktioniert, beende evcc durch drücken der Tastenkombination `CTRL-C`.
-
-- Verschiebe die erstellte Konfigurationsdatei in den Zielordner:
-
-  ```sh
-  sudo mv evcc.yaml /etc
-  ```
-
-- Starte evcc neu:
-
-  ```sh
-  sudo systemctl start evcc
-  ```
-
-- Gehe zurück zum Browser und lade die evcc Seite neu. Die Oberfläche sollte nun mit deinen konfigurierten Geräten zu sehen sein.
-
 ## Aktualisierung
 
 Um auf eine neue Version von evcc zu aktualisieren, führe folgende Schritte durch:
@@ -142,6 +96,14 @@ Um auf eine neue Version von evcc zu aktualisieren, führe folgende Schritte dur
 Wenn das unstable Repository (Nightly Versionen) hinzugefügt wurde, wird beim Update immer auf die letzte verfügbare Nightly Version aktualisiert. Sollte das nicht mehr erwünscht sein, muss das unstable Repository mittels `sudo rm /etc/apt/sources.list.d/evcc-unstable.list` entfernt werden.
 :::
 
+## Konfiguration
+
+Es wird eine funktionierende evcc Konfiguration benötigt.
+
+
+
+Folge nun der [Anleitung](./configuration#konfiguration-mit-assistenten) zur Erstellung einer Konfiguration mit dem Konfigurationsassistenten.
+
 ## Downgrade
 
 Mit folgendem Befehl kann man auf eine ältere Version von evcc wechseln: