Add evcc linux image (#861)

Author: naltatis

docs/Home.md

@@ -4,11 +4,12 @@ sidebar_position: 1
 
 # Einführung
 
-evcc ermöglicht das Laden von Elektrofahrzeugen (EV) bedarfsgerecht zu steuern und den dazu benötigten Energiebezug zu optimieren. Es kann eine Photovoltaikanlage (PV) angebunden werden, um so viel selbsterzeugte Energie wie möglich ins EV zu laden, oder es können auch Anbieter mit dynamischen Strompreisen angebunden werden.
+evcc optimiert das Laden deines Elektrofahrzeugs mit selbsterzeugtem Solarstrom oder günstigen Stromtarifen.
+Die Software funktioniert herstellerübergreifend mit hunderten von Wallboxen, PV-Anlagen und Fahrzeugen.
+evcc läuft lokal auf einem Raspberry Pi oder NAS - keine Cloud erforderlich.
 
-Normalerweise muss die Wallbox dazu mit der bestehenden PV-Installation kompatibel, oft sogar vom selben Hersteller sein. evcc ermöglicht dies jedoch herstellerübergreifend und mit einer Vielzahl von Wallboxen, Strommessgeräten und PV-Wechselrichtern, ohne dass diese speziell dazu vorgesehen sein müssen.
+Lerne, wie du [evcc auf deiner Hardware installierst](/docs/installation).
 
-Dazu wird evcc auf einem System im lokalen Netzwerk installiert, so dass es mit allen notwendigen Geräten kommunizieren kann. evcc selbst arbeitet dabei vollständig lokal und benötigt selbst keine Cloud-Anbindung, wenn keine der angebundenen Komponenten dies erfordert. Die Software ist sehr genügsam, so dass ein einfaches NAS (Netzwerkspeichergerät) oder ein Kleinstcomputersystem wie z. B. ein Raspberry Pi (oder ähnliches) völlig ausreichen.
 
 ![Screenshot](screenshot.webp)
 

docs/installation/configuration.mdx

@@ -5,7 +5,7 @@ sidebar_position: 10
 import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
 
-# Konfiguration
+# evcc.yaml erstellen
 
 Diese Anleitung beschreibt, wie du an eine funktionierende `evcc.yaml` Datei kommst.
 

docs/installation/considerations.mdx

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 1
+sidebar_position: 2
 ---
 
 import Tabs from "@theme/Tabs";

docs/installation/docker.mdx

@@ -31,7 +31,7 @@ Es gibt mehrere Möglichkeiten, diese zu erstellen:
   Verwende die damit erstellte `evcc.yaml` Datei für deine Docker Installation.
 
 2. **Manuell:** Erstelle die `evcc.yaml` manuell.
-  Hier findest du eine Anleitung unter [Konfiguration](./configuration).
+  Hier findest du eine Anleitung unter [evcc.yaml erstellen](./configuration).
 
 3. **Assistent in Docker:**
   Praktisch, wenn du Docker auf einem Linux System installiert hast.
@@ -276,7 +276,7 @@ Du solltest die evcc Oberfläche sehen und aufgefordert werden ein Administratio
 
 Solltest du keine Verbindung herstellen können, überprüfe die Logs deines Containers.
 Wenn du die Oberfläche siehst, aber eine Fehlermeldung angezeigt wird, überprüfe die Konfiguration in der `evcc.yaml` Datei.
-Weitere Details findest du in [Konfiguration](./configuration) oder in den [GitHub Diskussionen](https://github.com/evcc-io/evcc/discussions).
+Weitere Details findest du in [evcc.yaml erstellen](./configuration) oder in den [GitHub Diskussionen](https://github.com/evcc-io/evcc/discussions).
 
 ## Community Anleitungen
 

docs/installation/home-assistant.mdx

@@ -1,11 +1,11 @@
 ---
-sidebar_position: 7
+sidebar_position: 5
 ---
 
 import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
 
-# Home Assistant Add-on
+# Home Assistant
 
 :::info Wichtig
 Das evcc Home Assistant Add-on ist eine Community Integration und wird "noch" nicht offiziell von den evcc Maintainern unterstützt.
@@ -99,7 +99,7 @@ Um die Konfigurationsdatei anzulegen bzw. zu editieren, hast du verschiedene Mö
 - [File Editor](https://github.com/home-assistant/addons/tree/master/configurator), stelle sicher, dass Du die Option "Enforce Basepath" in der Add-on Konfiguration deaktiviert hast, starte das Add-on neu und navigiere nach `/addon_configs/49686a9f_evcc`
 - [Advanced SSH & Web Terminal](https://github.com/hassio-addons/addon-ssh), navigiere nach `/addon_configs/49686a9f_evcc` und verwende z. B. nano
 
-Unter [Konfiguration](./configuration) findest du eine Anleitung, wie du den Inhalt für die `evcc.yaml` erstellen kannst.
+Unter [evcc.yaml erstellen](./configuration) findest du eine Anleitung, wie du den Inhalt für die `evcc.yaml` erstellen kannst.
 
 Wenn du erstmal mit einer Demo starten möchtest, starte evcc mit dem Parameter `--demo`.
 Weitere Informationen findest du unter [CLI Referenz](/docs/reference/cli/evcc).

docs/installation/index.md

@@ -1,16 +1,57 @@
 ---
 sidebar_position: 1
+hide_table_of_contents: true
 ---
 
+import NavCard from '@site/src/components/NavCard';
+import NavCardGrid from '@site/src/components/NavCardGrid';
+
 # Erste Schritte
 
 In diesem Abschnitt findest du Anleitungen für die Installation von evcc auf verschiedenen Plattformen.
+Falls du mehr über die Funktionsweise von Wallboxen und E-Auto-Laden erfahren möchtest, schau dir zuerst die [Vorüberlegungen](./installation/considerations) an.
+
+<NavCardGrid>
+  <NavCard 
+    to="/docs/installation/linux-image" 
+    title="Raspberry Pi & Co." 
+    description="Einfachste Installation. Fertiges SD-Karten-Image." 
+    fullWidth={true}
+    highlight={true}
+  />
+</NavCardGrid>
+
+<NavCardGrid>
+  <NavCard 
+    to="/docs/installation/docker" 
+    title="Docker" 
+    description="Synology, QNAP, Unraid und andere NAS Systeme" 
+  />
+  <NavCard 
+    to="/docs/installation/home-assistant" 
+    title="Home Assistant" 
+    description="Als Add-on über HACS." 
+  />
+  <NavCard 
+    to="/docs/installation/proxmox" 
+    title="Proxmox" 
+    description="LXC-Container via Helper-Script." 
+  />
+  <NavCard 
+    to="/docs/installation/linux" 
+    title="Linux" 
+    description="Debian/Ubuntu und andere Distributionen." 
+  />
+  <NavCard 
+    to="/docs/installation/macos" 
+    title="macOS" 
+    description="Via Homebrew." 
+  />
+  <NavCard 
+    to="/docs/installation/windows" 
+    title="Windows" 
+    description="Manuelle Installation. Nicht empfohlen aber geht." 
+  />
+</NavCardGrid>
 
-- [Vorüberlegungen](./installation/considerations)
-- [Linux / Raspberry Pi](./installation/linux)
-- [macOS](./installation/macos)
-- [Docker](./installation/docker)
-- [Windows](./installation/windows)
-- [Home Assistant Addon](./installation/home-assistant)
-- [Proxmox](./installation/proxmox)
-- [Konfiguration](./installation/configuration)
+Nach der Installation: [evcc.yaml erstellen](./installation/configuration)

docs/installation/linux-image.mdx

@@ -0,0 +1,143 @@
+---
+sidebar_position: 3
+---
+
+# Raspberry Pi & Co.
+
+Die einfachste Art, evcc auf einem Raspberry Pi oder ähnlichen Kleincomputern zu installieren.
+Fertig vorkonfiguriert!
+
+:::warning Experimentell
+Mit den evcc Linux Images kannst du evcc komplett über die Web UI einrichten.
+Im Regelfall brauchst du keine `evcc.yaml` oder Konsolen-Befehle.
+Die UI-Einrichtung ist allerdings noch als experimentell gekennzeichnet.
+Bei Problemen oder für Debugging sind ggf. weiterhin Konsolenbefehle erforderlich.
+:::
+
+## Schnellstart
+
+### Datei herunterladen
+
+Gehe zu den **[evcc Linux Images](https://github.com/evcc-io/images/releases)** und lade die neueste Version für Raspberry Pi herunter (`armbian_evcc-{version}_rpi4b.img.zip`).
+
+### SD-Karte beschreiben
+
+Falls noch nicht vorhanden: **[balenaEtcher herunterladen](https://etcher.balena.io/)**
+
+- SD-Karte in den Computer stecken
+- balenaEtcher öffnen
+- **Flash from file** → heruntergeladene Datei wählen
+- **Select target** → deine SD-Karte wählen
+- **Flash!** → warten bis fertig
+
+### Raspberry Pi starten
+
+- SD-Karte in den Raspberry Pi stecken
+- Netzwerkkabel anschließen (empfohlen) - alternativ [WLAN einrichten](#wifi)
+- Netzteil anschließen
+- Warten bis gestartet
+
+### evcc Web UI
+
+![evcc Passwort vergeben](screenshots/evcc-password.webp)
+
+- Browser öffnen
+- **[https://evcc.local/](https://evcc.local/)** eingeben
+  - Zertifikatmeldung muss akzeptiert werden (normal, Verbindung ist verschlüsselt)
+  - Alternativ via IP-Adresse, z.B. `https://192.168.1.123/` (IP im Router ermitteln)
+- Administrator-Passwort vergeben (beim ersten Start)
+- Geräte einrichten (Wallbox, PV-Anlage, Hausbatterie, Fahrzeuge)
+  - Hinweis: Mindestens ein Ladepunkt muss angelegt werden, damit evcc läuft
+
+![evcc Willkommen](screenshots/evcc-welcome.webp)
+
+**Fertig!** 🎉
+
+Systemkonfiguration und Updates funktionieren über [Cockpit](#cockpit).
+Melde dich dort einmal an, um das Standard-Linux-Passwort zu ändern.
+
+## WLAN einrichten {#wifi}
+
+Falls kein Netzwerkkabel vorhanden ist, erstellt der Raspberry Pi einen WLAN-Hotspot für die Ersteinrichtung.
+
+- Am Smartphone nach WLAN **"evcc-setup"** suchen
+- Verbinden (kein Passwort nötig)
+- Dein Heim-WLAN aus der Liste auswählen
+- WLAN-Passwort deines Heimnetzwerks eingeben
+- Raspberry Pi beendet den Hotspot und verbindet sich mit deinem Heim-WLAN
+- Weiter mit [evcc Web UI](#evcc-web-ui)
+
+Die WLAN-Konfiguration kann auch später über [Cockpit](#cockpit) vorgenommen werden.
+
+
+## Systemverwaltung via Cockpit {#cockpit}
+
+Cockpit ist eine grafische Systemverwaltung für Linux.
+Hier kannst du dein System konfigurieren, Updates installieren und Netzwerkeinstellungen ändern.
+
+- URL: [https://evcc.local:9090/](https://evcc.local:9090/)
+- Benutzer: `admin`
+- Passwort: `admin` (initial)
+
+Beim ersten Login wirst du aufgefordert, das Standard-Passwort zu ändern.
+Wähle ein sicheres Passwort für die Systemverwaltung.
+Falls du es vergisst, musst du die SD-Karte neu flashen.
+Es gibt keine "Passwort vergessen" Funktion.
+
+![Cockpit Login](screenshots/cockpit.webp)
+
+**Wichtige Funktionen:**
+- **System:** Übersicht über CPU, Speicher und Festplatte
+- **Logs:** Systemprotokolle einsehen
+- **Networking:** Netzwerk und WLAN konfigurieren
+- **Terminal:** Zugriff auf die Kommandozeile
+- **Software Updates:** System aktualisieren
+
+:::note
+Das Linux-Benutzerpasswort und das evcc Administrator-Passwort sind unterschiedlich.
+Das eine ist für die Linux-Systemverwaltung, das andere für evcc.
+:::
+
+## Hardware-Empfehlungen
+
+evcc läuft auf verschiedenen Kleincomputern und braucht nur wenig Ressourcen.
+Bereits 1 GB RAM reichen völlig aus.
+
+**Unterstützte Geräte:**
+- Raspberry Pi 3, 4 und 5 - alle Modelle funktionieren gleich gut
+- NanoPi R3S - kompakt, günstig und kommt mit Gehäuse und integriertem eMMC-Speicher
+
+**Speicher:**
+Mindestens 16 GB SD-Karte oder eMMC.
+Für längere Lebensdauer empfehlen wir eMMC statt SD-Karte (z.B. beim NanoPi).
+SD-Karten können durch häufige Schreibvorgänge verschleißen.
+Siehe auch [Armbian Empfehlungen](https://docs.armbian.com/User-Guide_Getting-Started/#what-do-i-need).
+
+**Netzteil:**
+Original-Netzteil des jeweiligen Herstellers verwenden.
+
+**Netzwerk:**
+Kabelverbindung wird stark empfohlen.
+WLAN ist möglich, aber oft weniger stabil.
+
+## Über das evcc Linux Image
+
+Das evcc Linux Image basiert auf [Armbian](https://www.armbian.com/) und bietet einige praktische Funktionen:
+
+**Updates:**
+- Betriebssystem: Sicherheitsupdates werden automatisch installiert
+- evcc: Updates können über [Cockpit](#cockpit) durchgeführt werden
+
+**Zugriff per SSH:**
+Du kannst dich via SSH mit dem `admin` Benutzer verbinden (gleiche Zugangsdaten wie [Cockpit](#cockpit)).
+
+**Alternative Zugänge:**
+- Verschlüsselt: https://evcc.local/ (empfohlen)
+- Unverschlüsselt: http://evcc.local:7070/ (falls Zertifikatmeldung stört)
+
+Weitere technische Details findest du im [GitHub Repository](https://github.com/evcc-io/images).
+
+## Nächste Schritte
+
+Im Bereich [Funktionen](/docs/features/solar-charging) kannst du alle Möglichkeiten von evcc kennenlernen.
+Lade dir auch die [iOS/Android App](/docs/features/app) herunter.

docs/installation/linux.mdx

@@ -1,13 +1,17 @@
 ---
-sidebar_position: 2
+sidebar_position: 7
 ---
 
 import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
 
-# Linux / Raspberry Pi
+# Linux
 
-Diese Anleitung beschreibt die Installation für apt-basierte Linux Distributionen wie Debian, Ubuntu und Raspberry Pi OS.
+Diese Anleitung beschreibt die Installation für apt-basierte Linux Distributionen wie Debian und Ubuntu.
+
+:::tip Raspberry Pi
+Für Raspberry Pi empfehlen wir die einfachere Installation mit [evcc Linux Image](./linux-image).
+:::
 
 :::note
 Für andere Linux Distributionen schau dir die [Docker](./docker) Anleitung oder den [Manuelle Installation](#manual) Abschnitt an.
@@ -86,7 +90,7 @@ Dieser Befehl fügt den Benutzer evcc zur Gruppe plugdev hinzu.
 Die Gruppe plugdev dient dazu, Zugriffsrechte für Plug-in-Geräte (wie USB, serielle Schnittstelle usw.) zu erteilen, ohne dass Root-Rechte erforderlich sind.
 :::
 
-## Konfiguration
+## evcc.yaml erstellen
 
 Für den Betrieb musst du eine funktionierende `evcc.yaml` Konfigurationsdatei erstellen.
 Neben allgemeinen Einstellungen beinhaltet die Konfiguration die Definition der einzelnen Komponenten (Zähler, Wallbox, Fahrzeug, ...).
@@ -131,7 +135,7 @@ Benötigt deine Konfiguration noch Anpassungen kannst du entweder den Konfigurat
   sudo systemctl restart evcc
   ```
 
-Unter [Konfiguration](./configuration) findest du weitere Informationen und Beispiele zur Konfiguration von evcc.
+Unter [evcc.yaml erstellen](./configuration) findest du weitere Informationen und Beispiele zur Konfiguration von evcc.
 
 ## Aktualisierung
 
@@ -251,9 +255,9 @@ Neben dem Debian/Ubuntu APT Paket, stellen wir auch weitere Binaries für Linux
   ```
 - Du solltest die aktuelle Version von evcc sehen (bspw. `evcc version 0.xxx.y`).
 
-### Konfiguration
+### evcc.yaml erstellen
 
-Erstelle dir nach der Anleitung unter [Konfiguration](./configuration) eine funktionierende `evcc.yaml` Konfigurationsdatei.
+Erstelle dir nach der Anleitung unter [evcc.yaml erstellen](./configuration) eine funktionierende `evcc.yaml` Konfigurationsdatei.
 Diese kannst du mit folgendem Befehl starten:
 
 ```sh

docs/installation/macos.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 3
+sidebar_position: 8
 ---
 
 # macOS
@@ -45,7 +45,7 @@ Wenn du evcc ohne Paketmanager installieren willst oder eine nightly Version tes
   brew services stop evcc
   ```
 
-## Konfiguration
+## evcc.yaml erstellen
 
 Für den Betrieb musst du eine funktionierende `evcc.yaml` Konfigurationsdatei erstellen.
 Neben allgemeinen Einstellungen beinhaltet die Konfiguration die Definition der einzelnen Komponenten (Zähler, Wallbox, Fahrzeug, ...).
@@ -90,9 +90,9 @@ Benötigt deine Konfiguration noch Anpassungen kannst du entweder den Konfigurat
   brew services restart evcc
   ```
 
-Unter [Konfiguration](./configuration) findest du weitere Informationen und Beispiele zur Konfiguration von evcc.
+Unter [evcc.yaml erstellen](./configuration) findest du weitere Informationen und Beispiele zur Konfiguration von evcc.
 
-## Konfiguration
+## evcc.yaml erstellen
 
 Es wird eine funktionierende evcc Konfiguration benötigt.
 
@@ -146,9 +146,9 @@ Hier findest du die Anleitung für die manuelle Installation von evcc auf macOS.
   ```
 - Du solltest die aktuelle Version von evcc sehen (bspw. `evcc version 0.xxx.y`).
 
-### Konfiguration
+### evcc.yaml erstellen
 
-Erstelle dir nach der Anleitung unter [Konfiguration](./configuration) eine funktionierende `evcc.yaml` Konfigurationsdatei.
+Erstelle dir nach der Anleitung unter [evcc.yaml erstellen](./configuration) eine funktionierende `evcc.yaml` Konfigurationsdatei.
 Diese kannst du mit folgendem Befehl starten:
 
 ```sh

docs/installation/proxmox.mdx

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 8
+sidebar_position: 6
 ---
 
 # Proxmox