diff --git a/docs/Home.md b/docs/Home.md
index 421fc039a..b89f7c85d 100644
--- a/docs/Home.md
+++ b/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.
diff --git a/docs/installation/configuration.mdx b/docs/installation/configuration.mdx
index 331ac51dc..08267e8d4 100644
--- a/docs/installation/configuration.mdx
+++ b/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.
diff --git a/docs/installation/considerations.mdx b/docs/installation/considerations.mdx
index fd6ce0da1..6305ca8cb 100644
--- a/docs/installation/considerations.mdx
+++ b/docs/installation/considerations.mdx
@@ -1,5 +1,5 @@
---
-sidebar_position: 1
+sidebar_position: 2
---
import Tabs from "@theme/Tabs";
diff --git a/docs/installation/docker.mdx b/docs/installation/docker.mdx
index 8782040a6..fa93cec3f 100644
--- a/docs/installation/docker.mdx
+++ b/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
diff --git a/docs/installation/home-assistant.mdx b/docs/installation/home-assistant.mdx
index 6b58648d1..142c1c424 100644
--- a/docs/installation/home-assistant.mdx
+++ b/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).
diff --git a/docs/installation/index.md b/docs/installation/index.md
index 34b1f79e2..3d8f08b21 100644
--- a/docs/installation/index.md
+++ b/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.
+
+
+
+
+
+
+
+
+
+
+
+
+
-- [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)
diff --git a/docs/installation/linux-image.mdx b/docs/installation/linux-image.mdx
new file mode 100644
index 000000000..ef4368fad
--- /dev/null
+++ b/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
+
+
+
+- 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
+
+
+
+**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.
+
+
+
+**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.
diff --git a/docs/installation/linux.mdx b/docs/installation/linux.mdx
index bdfba6ca2..1748c4781 100644
--- a/docs/installation/linux.mdx
+++ b/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
diff --git a/docs/installation/macos.md b/docs/installation/macos.md
index ac1e1230e..696934eb2 100644
--- a/docs/installation/macos.md
+++ b/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
diff --git a/docs/installation/proxmox.mdx b/docs/installation/proxmox.mdx
index f6a4cc3d9..e80860325 100644
--- a/docs/installation/proxmox.mdx
+++ b/docs/installation/proxmox.mdx
@@ -1,5 +1,5 @@
---
-sidebar_position: 8
+sidebar_position: 6
---
# Proxmox
diff --git a/docs/installation/screenshots/cockpit.webp b/docs/installation/screenshots/cockpit.webp
new file mode 100644
index 000000000..1e3aff934
Binary files /dev/null and b/docs/installation/screenshots/cockpit.webp differ
diff --git a/docs/installation/screenshots/evcc-password.webp b/docs/installation/screenshots/evcc-password.webp
new file mode 100644
index 000000000..c50a9f029
Binary files /dev/null and b/docs/installation/screenshots/evcc-password.webp differ
diff --git a/docs/installation/screenshots/evcc-welcome.webp b/docs/installation/screenshots/evcc-welcome.webp
new file mode 100644
index 000000000..4442831aa
Binary files /dev/null and b/docs/installation/screenshots/evcc-welcome.webp differ
diff --git a/docs/installation/windows.mdx b/docs/installation/windows.mdx
index 189976779..9e14ec2ff 100644
--- a/docs/installation/windows.mdx
+++ b/docs/installation/windows.mdx
@@ -1,5 +1,5 @@
---
-sidebar_position: 6
+sidebar_position: 9
---
# Windows
@@ -27,9 +27,9 @@ Allerdings wird evcc typischerweise in einer Linux-Umgebung (z.B. Raspberry Pi)
```
- Du solltest nun die aktuelle Version von evcc sehen (z.B. `evcc version 0.xxx.y`).
-## Konfiguration
+## evcc.yaml erstellen
-Erstelle eine funktionierende `evcc.yaml` Konfigurationsdatei, indem du den Anweisungen unter [Konfiguration](./configuration) befolgst.
+Erstelle eine funktionierende `evcc.yaml` Konfigurationsdatei, indem du den Anweisungen unter [evcc.yaml erstellen](./configuration) befolgst.
Mit folgendem Befehl kannst du evcc starten:
```sh
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/Home.md b/i18n/en/docusaurus-plugin-content-docs/current/Home.md
index 916a35fa0..69dd2d938 100644
--- a/i18n/en/docusaurus-plugin-content-docs/current/Home.md
+++ b/i18n/en/docusaurus-plugin-content-docs/current/Home.md
@@ -4,12 +4,11 @@ sidebar_position: 1
# Introduction
-evcc controls Electric Vehicle (EV) charging as required to optimise for the current energy situation.
-A Photovoltaic (PV) system can be connected in order to charge the EV with as much self-produced energy as possible, and/or grid providers can be connected to allow for exploitation of dynamic electricity prices.
+evcc optimizes charging your electric vehicle with self-generated solar energy or low-cost electricity tariffs.
+The software works across manufacturers with hundreds of wallboxes, solar systems, and vehicles.
+evcc runs locally on a Raspberry Pi or NAS - no cloud required.
-Normally, the wallbox must be compatible with the existing PV installation, often requiring equipment from the same manufacturer. However, evcc works across manufacturers and with a wide variety of wallboxes, electricity measuring devices, and PV inverters, without requiring specific manufacturer compatibility between them.
-
-evcc is installed onto a system in the local network, so that it can communicate properly with all the necessary devices. It does this completely locally, and without any reliance on cloud connectivity (though connected components may have their own requirements). The software itself is very lean, and something like a NAS (network attached storage) or a Raspberry Pi (or similar) is completely sufficient to achieve full functionality.
+Learn how to [install evcc on your hardware](/docs/installation).
@@ -31,14 +30,14 @@ evcc is installed onto a system in the local network, so that it can communicate
evcc requires at least the following:
- a supported [Wallbox or Switchable Socket](/docs/devices/chargers)
-- a supported [Energy Meter](/docs/devices/meters) at the house connection, or alternatively a supported PV inverter / other metering device that can measure current energy production
+- a supported [Energy Meter](/docs/devices/meters) at the house connection, or alternatively a supported solar inverter / other metering device that can measure current energy production
- a supported system to run evcc on!
Optionally:
- one or more supported [Vehicles](/docs/devices/vehicles) to collect charge status / level information
- additional supported Wallboxes or Switchable Sockets
-- supported PV inverter(s)
+- supported Solar inverter(s)
- supported Battery Storage System(s)
- a supported [Energy Management System](/docs/reference/configuration/hems) (such as SMA Sunny Home Manager)
- information on a dynamic electricity tariff
@@ -78,13 +77,13 @@ Here are [the slides](https://speakerdeck.com/naltatis/evcc-open-source-sonne-ta
[](https://www.youtube.com/watch?v=qN8JwBWOlzw)
-### verdrahtet: PV surplus with evcc (German)
+### verdrahtet: Solar surplus with evcc (German)
Tackles evcc basics, integration with ioBroker, and integrating a homematic switch.
[](https://youtu.be/6JxktkEaZ2o)
-### haus-automatisierung.com: Charging an Electric Vehicle with PV Surplus (German)
+### haus-automatisierung.com: Charging an Electric Vehicle with Solar Surplus (German)
Tackles evcc basics, custom plugins, control via MQTT and ioBroker, as well as different installation options.
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/installation/configuration.mdx b/i18n/en/docusaurus-plugin-content-docs/current/installation/configuration.mdx
index 51032456e..f38fa66ec 100644
--- a/i18n/en/docusaurus-plugin-content-docs/current/installation/configuration.mdx
+++ b/i18n/en/docusaurus-plugin-content-docs/current/installation/configuration.mdx
@@ -5,7 +5,7 @@ sidebar_position: 10
import Tabs from "@theme/Tabs";
import TabItem from "@theme/TabItem";
-# Configuration
+# Create evcc.yaml
This guide describes how to create a working `evcc.yaml` file.
@@ -71,7 +71,7 @@ If errors occur, you can get additional information using the following commands
evcc -c evcc.yaml checkconfig
```
-- Meters (Grid, PV, Battery)
+- Meters (Grid, Solar, Battery)
```sh
evcc -c evcc.yaml -l debug meter
@@ -134,7 +134,7 @@ meters:
template: demo-meter
usage: grid
power: -1000 # 1 kW feed-in
- # replace with your real pv system
+ # replace with your real solar system
- name: my_pv
type: template
template: demo-meter
@@ -200,7 +200,7 @@ Go through the file step by step and adjust the values to your setup:
- Replace the demo devices with your own [meters](../devices/meters), [wallboxes](../devices/chargers), and [vehicles](../devices/vehicles).
- If you don't have a battery, you can remove that section completely.
-- If you have multiple PV systems, you can duplicate the corresponding sections.
+- If you have multiple solar systems, you can duplicate the corresponding sections.
- If you have multiple wallboxes, copy the loadpoint and charger sections and adjust the names.
Note that the individual entries reference each other.
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/installation/considerations.mdx b/i18n/en/docusaurus-plugin-content-docs/current/installation/considerations.mdx
index ea0bf6730..ffddf310f 100644
--- a/i18n/en/docusaurus-plugin-content-docs/current/installation/considerations.mdx
+++ b/i18n/en/docusaurus-plugin-content-docs/current/installation/considerations.mdx
@@ -1,5 +1,5 @@
---
-sidebar_position: 1
+sidebar_position: 2
---
import Tabs from "@theme/Tabs";
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/installation/home-assistant.mdx b/i18n/en/docusaurus-plugin-content-docs/current/installation/home-assistant.mdx
index 5426a7224..f684f75a2 100644
--- a/i18n/en/docusaurus-plugin-content-docs/current/installation/home-assistant.mdx
+++ b/i18n/en/docusaurus-plugin-content-docs/current/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 Addon
+# Home Assistant
:::info
The evcc Home Assistant addon is a community integration and is not officially supported by the evcc maintainers.
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/installation/index.md b/i18n/en/docusaurus-plugin-content-docs/current/installation/index.md
index 7459098e2..d3066da65 100644
--- a/i18n/en/docusaurus-plugin-content-docs/current/installation/index.md
+++ b/i18n/en/docusaurus-plugin-content-docs/current/installation/index.md
@@ -1,16 +1,57 @@
---
sidebar_position: 1
+hide_table_of_contents: true
---
-# Installing evcc
+import NavCard from '@site/src/components/NavCard';
+import NavCardGrid from '@site/src/components/NavCardGrid';
+
+# Getting Started
In this section you will find installation guides for evcc on various platforms.
+If you want to learn more about how wallboxes and EV charging work, first check out the [preliminary considerations](./installation/considerations).
+
+
+
+
+
+
+
+
+
+
+
+
+
-- [Preliminary Considerations](./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)
-- [Configuration](./installation/configuration)
+After installation: [Create evcc.yaml](./installation/configuration)
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/installation/linux-image.mdx b/i18n/en/docusaurus-plugin-content-docs/current/installation/linux-image.mdx
new file mode 100644
index 000000000..5a75d73d7
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/installation/linux-image.mdx
@@ -0,0 +1,142 @@
+---
+sidebar_position: 3
+---
+
+# Raspberry Pi & Co.
+
+The easiest way to install evcc on a Raspberry Pi or similar single-board computers.
+Pre-configured and ready to go!
+
+:::warning Experimental
+With the evcc Linux images, you can set up evcc completely via the web UI.
+Usually, you don't need an `evcc.yaml` or console commands.
+However, the UI setup is still marked as experimental.
+In case of problems or for debugging, console commands may still be required.
+:::
+
+## Quick Start
+
+### Download File
+
+Go to the **[evcc Linux Images](https://github.com/evcc-io/images/releases)** and download the latest version for Raspberry Pi (`armbian_evcc-{version}_rpi4b.img.zip`).
+
+### Flash SD Card
+
+If not already available: **[Download balenaEtcher](https://etcher.balena.io/)**
+
+- Insert SD card into computer
+- Open balenaEtcher
+- **Flash from file** → select downloaded file
+- **Select target** → select your SD card
+- **Flash!** → wait until finished
+
+### Start Raspberry Pi
+
+- Insert SD card into Raspberry Pi
+- Connect network cable (recommended) - alternatively [set up WiFi](#wifi)
+- Connect power adapter
+- Wait until started
+
+### evcc Web UI
+
+
+
+- Open browser
+- Enter **[https://evcc.local/](https://evcc.local/)**
+ - Certificate warning must be accepted (normal, connection is encrypted)
+ - Alternatively via IP address, e.g., `https://192.168.1.123/` (determine IP in router)
+- Set administrator password (on first start)
+- Set up devices (wallbox, solar system, home battery, vehicles)
+ - Note: At least one loadpoint must be created for evcc to run
+
+
+
+**Done!** 🎉
+
+System configuration and updates work via [Cockpit](#cockpit).
+Log in there once to change the default Linux password.
+
+## Set up WiFi {#wifi}
+
+If no network cable is available, the Raspberry Pi creates a WiFi hotspot for initial setup.
+
+- Search for WiFi **"evcc-setup"** on your smartphone
+- Connect (no password required)
+- Select your home WiFi network from the list
+- Enter your home WiFi password
+- Raspberry Pi ends the hotspot and connects to your home WiFi
+- Continue with [evcc Web UI](#evcc-web-ui)
+
+WiFi configuration can also be done later via [Cockpit](#cockpit).
+
+## System Management via Cockpit {#cockpit}
+
+Cockpit is a graphical system management interface for Linux.
+Here you can configure your system, install updates, and change network settings.
+
+- URL: [https://evcc.local:9090/](https://evcc.local:9090/)
+- User: `admin`
+- Password: `admin` (initial)
+
+On first login, you'll be prompted to change the default password.
+Choose a secure password for system management.
+If you forget it, you'll need to flash the SD card again.
+There is no "forgot password" function.
+
+
+
+**Important Functions:**
+- **System:** Overview of CPU, memory, and disk
+- **Logs:** View system logs
+- **Networking:** Configure network and WiFi
+- **Terminal:** Access to command line
+- **Software Updates:** Update system
+
+:::note
+The Linux user password and the evcc administrator password are different.
+One is for Linux system management, the other for evcc.
+:::
+
+## Hardware Recommendations
+
+evcc runs on various single-board computers and needs only few resources.
+Even 1 GB RAM is completely sufficient.
+
+**Supported Devices:**
+- Raspberry Pi 3, 4, and 5 - all models work equally well
+- NanoPi R3S - compact, affordable, and comes with case and integrated eMMC storage
+
+**Storage:**
+At least 16 GB SD card or eMMC.
+For longer lifespan, we recommend eMMC instead of SD card (e.g., with NanoPi).
+SD cards can wear out from frequent write operations.
+See also [Armbian recommendations](https://docs.armbian.com/User-Guide_Getting-Started/#what-do-i-need).
+
+**Power Supply:**
+Use original power supply from respective manufacturer.
+
+**Network:**
+Wired connection is strongly recommended.
+WiFi is possible but often less stable.
+
+## About the evcc Linux Image
+
+The evcc Linux image is based on [Armbian](https://www.armbian.com/) and offers some practical features:
+
+**Updates:**
+- Operating system: Security updates are automatically installed
+- evcc: Updates can be performed via [Cockpit](#cockpit)
+
+**SSH Access:**
+You can connect via SSH with the `admin` user (same credentials as [Cockpit](#cockpit)).
+
+**Alternative Access:**
+- Encrypted: https://evcc.local/ (recommended)
+- Unencrypted: http://evcc.local:7070/ (if certificate warning bothers you)
+
+More technical details can be found in the [GitHub Repository](https://github.com/evcc-io/images).
+
+## Next Steps
+
+In the [Features](/docs/features/solar-charging) section, you can learn about all possibilities of evcc.
+Also download the [iOS/Android app](/docs/features/app).
\ No newline at end of file
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/installation/linux.mdx b/i18n/en/docusaurus-plugin-content-docs/current/installation/linux.mdx
index 2024643c1..2270b9955 100644
--- a/i18n/en/docusaurus-plugin-content-docs/current/installation/linux.mdx
+++ b/i18n/en/docusaurus-plugin-content-docs/current/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
-This guide is aimed at apt-based Linux distributions like Debian, Ubuntu, and Raspberry Pi OS.
+This guide describes installation for apt-based Linux distributions like Debian and Ubuntu.
+
+:::tip Raspberry Pi
+For Raspberry Pi, we recommend the easier installation with [evcc Linux Image](./linux-image).
+:::
:::note
For other Linux distributions, see the [Docker](./docker) guide or [Manual Installation](#manual) section.
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/installation/macos.md b/i18n/en/docusaurus-plugin-content-docs/current/installation/macos.md
index 77bb6587b..07157d8fe 100644
--- a/i18n/en/docusaurus-plugin-content-docs/current/installation/macos.md
+++ b/i18n/en/docusaurus-plugin-content-docs/current/installation/macos.md
@@ -1,5 +1,5 @@
---
-sidebar_position: 3
+sidebar_position: 8
---
# macOS
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/installation/proxmox.mdx b/i18n/en/docusaurus-plugin-content-docs/current/installation/proxmox.mdx
index 5557481f3..f80dd8481 100644
--- a/i18n/en/docusaurus-plugin-content-docs/current/installation/proxmox.mdx
+++ b/i18n/en/docusaurus-plugin-content-docs/current/installation/proxmox.mdx
@@ -1,5 +1,5 @@
---
-sidebar_position: 8
+sidebar_position: 6
---
# Proxmox
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/installation/screenshots/cockpit.webp b/i18n/en/docusaurus-plugin-content-docs/current/installation/screenshots/cockpit.webp
new file mode 100644
index 000000000..1e3aff934
Binary files /dev/null and b/i18n/en/docusaurus-plugin-content-docs/current/installation/screenshots/cockpit.webp differ
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/installation/screenshots/evcc-password.webp b/i18n/en/docusaurus-plugin-content-docs/current/installation/screenshots/evcc-password.webp
new file mode 100644
index 000000000..c50a9f029
Binary files /dev/null and b/i18n/en/docusaurus-plugin-content-docs/current/installation/screenshots/evcc-password.webp differ
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/installation/screenshots/evcc-welcome.webp b/i18n/en/docusaurus-plugin-content-docs/current/installation/screenshots/evcc-welcome.webp
new file mode 100644
index 000000000..4442831aa
Binary files /dev/null and b/i18n/en/docusaurus-plugin-content-docs/current/installation/screenshots/evcc-welcome.webp differ
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/installation/windows.mdx b/i18n/en/docusaurus-plugin-content-docs/current/installation/windows.mdx
index 8328118d1..13e46e4a8 100644
--- a/i18n/en/docusaurus-plugin-content-docs/current/installation/windows.mdx
+++ b/i18n/en/docusaurus-plugin-content-docs/current/installation/windows.mdx
@@ -1,5 +1,5 @@
---
-sidebar_position: 6
+sidebar_position: 9
---
# Windows
@@ -28,7 +28,7 @@ However, evcc is typically used in a Linux environment (e.g., Raspberry Pi).
## Configuration
-Create a working `evcc.yaml` configuration file following the instructions under [Configuration](./configuration).
+Create a working `evcc.yaml` configuration file following the instructions under [Create evcc.yaml](./configuration).
You can start it with the following command:
```sh
diff --git a/src/components/NavCard.js b/src/components/NavCard.js
new file mode 100644
index 000000000..8ba5ed28a
--- /dev/null
+++ b/src/components/NavCard.js
@@ -0,0 +1,40 @@
+import React from 'react';
+import Link from '@docusaurus/Link';
+
+export default function NavCard({ to, title, description, fullWidth = false, highlight = false }) {
+ return (
+ {
+ e.currentTarget.style.boxShadow = '0 4px 12px 0 rgba(0, 0, 0, 0.15)';
+ e.currentTarget.style.transform = 'translateY(-2px)';
+ e.currentTarget.style.borderColor = 'var(--ifm-color-primary)';
+ }}
+ onMouseLeave={(e) => {
+ e.currentTarget.style.boxShadow = '0 2px 4px 0 rgba(0, 0, 0, 0.1)';
+ e.currentTarget.style.transform = 'translateY(0)';
+ e.currentTarget.style.borderColor = 'var(--ifm-color-emphasis-300)';
+ }}
+ >
+
{title}
+
{description}
+
+ );
+}
\ No newline at end of file
diff --git a/src/components/NavCardGrid.js b/src/components/NavCardGrid.js
new file mode 100644
index 000000000..a3fde04ec
--- /dev/null
+++ b/src/components/NavCardGrid.js
@@ -0,0 +1,16 @@
+import React from 'react';
+
+export default function NavCardGrid({ children, className = "" }) {
+ return (
+