# Problem melden > Erklärt, wohin dein Problem gehört, welche Angaben für schnelle Hilfe nötig sind und wie du auf deiner Installation an die Logs kommst. Etwas funktioniert nicht wie erwartet? Hilfreich sind eine klare Beschreibung, deine Konfiguration und ein Log, das das Problem zeigt. Diese Seite zeigt, wo du dein Problem meldest und wie du an diese Angaben kommst. ## Warum eine gute Beschreibung wichtig ist Jede Installation ist anders. Geräte, Firmware-Versionen, Einstellungen und Netzwerk unterscheiden sich von Haus zu Haus. Wir sind eine Community aus Anwendern und Entwicklern, die sich gegenseitig helfen. Wir helfen auch dir gerne, können aber nicht in dein System hineinschauen. Deine Beschreibung ist alles, was wir sehen. Mit Beschreibung, Konfiguration und einem Log, das das Problem zeigt, finden wir die Ursache oft schon mit der ersten Antwort. Je genauer die Beschreibung, desto eher können wir einen Fehler nachstellen. Erst dann lässt er sich beheben. Auch andere mit demselben Problem haben etwas davon, weil sie deinen Beitrag und die Lösung finden. ## Bevor du ein Problem meldest * **Aktualisieren**: Nutze die neueste Version. Probiere bei Fehlern auch die Nightly-Version aus, vielleicht ist das Problem dort schon behoben. * **Suchen**: Schau in [Discussions](https://github.com/evcc-io/evcc/discussions), [Issues](https://github.com/evcc-io/evcc/issues) und [häufige Fragen](/de/faq), auch in geschlossene Beiträge. Gibt es dein Problem dort schon, ergänze deine Angaben in diesem Beitrag. * **Nachstellen**: Stelle das Problem noch einmal nach und notiere die Uhrzeit. Mit ihr findest du die passenden Log-Einträge. * **Eingrenzen**: Schalte externe Automatisierungen vorübergehend ab (z. B. Home Assistant, Node-RED, ioBroker). Steuern zwei Systeme dasselbe Gerät, ist das oft die Ursache. * **Einzeln melden**: Beschreibe pro Beitrag nur ein Problem. ## Wohin gehört das Problem? * **[evcc-io/evcc](#app)**: Haupt-Repository für Laden, Geräte, Tarife und Weboberfläche * **[evcc-io/app](https://github.com/evcc-io/app/issues/new/choose)**: App für iOS und Android, wenn im Webbrowser alles funktioniert * **[evcc-io/docs](https://github.com/evcc-io/docs/issues/new/choose)**: Dokumentation auf [docs.evcc.io](https://docs.evcc.io). Die Geräteseiten werden aus dem Haupt-Repository erzeugt. Der Link *Seite bearbeiten* am Ende jeder Seite führt zur richtigen Quelle. * **[evcc-io/evcc.io](https://github.com/evcc-io/evcc.io/issues/new/choose)**: Website [evcc.io](https://evcc.io), z. B. Tippfehler * **[evcc-io/optimizer](https://github.com/evcc-io/optimizer/issues/new/choose)**: Optimizer, wenn die berechneten Ergebnisse unplausibel oder unerwartet sind Probleme mit dem evcc Linux Image gehören zu [evcc-io/images](https://github.com/evcc-io/images/issues/new/choose), Probleme mit der Home Assistant App zu [evcc-io/hassio-addon](https://github.com/evcc-io/hassio-addon/issues/new/choose). ## Diskussion oder Fehler? * **[Diskussion](https://github.com/evcc-io/evcc/discussions)**: Fragen und Hilfe bei deiner Einrichtung. Unerwartetes Verhalten liegt meistens an der Konfiguration oder den Einstellungen. * **Fehler**: Etwas hat früher funktioniert und seit einem Update nicht mehr, oder das Verhalten widerspricht eindeutig der Dokumentation. Fehler meldest du als [Issue](https://github.com/evcc-io/evcc/issues). Wenn du nicht ausschließen kannst, dass es an den Einstellungen liegt, beginne mit einer Diskussion. ## Über die Weboberfläche melden Die Seite **Problem melden** trägt Version, System, Konfiguration und Logs für dich zusammen. Daraus entsteht eine vorbereitete Diskussion oder ein vorbereitetes Issue auf GitHub. Dafür brauchst du ein [GitHub-Konto](https://github.com/signup). 1. Öffne **Mehr → Problem melden**. 2. Wähle **Brauche Hilfe bei meiner Einrichtung** oder **Habe einen Fehler gefunden**. 3. Fülle **Titel**, **Beschreibung** und **Schritte zur Reproduktion** aus. Beschreibe, was du erwartet hast und was stattdessen passiert ist. 4. Prüfe die **Zusätzlichen Informationen**. Klicke bei **Logs** auf die Parameter und wähle Level, Zeilenanzahl und Bereiche. Für längere Zeiträume kannst du dir das [Log besorgen](#logs) und als Datei anhängen. Füge den **Zustand** nur hinzu, wenn jemand danach fragt. ![Seite Problem melden mit Beschreibung und zusätzlichen Informationen](/_astro/report-a-problem-de-light-1x.CQ6aRvf-.webp) Seite Problem melden mit Beschreibung und zusätzlichen Informationen 5. Klicke auf **GitHub Issue erstellen…** oder **GitHub Diskussion starten…**. 6. Sind die zusätzlichen Informationen zu lang für einen Link, zeigt der Dialog zwei Schritte. Erstelle zuerst den Beitrag auf GitHub. Wechsle dann zurück zu deiner Instanz, klicke auf **Zusätzliche Informationen kopieren** und füge sie an der markierten Stelle in den Beitrag ein. Ohne diesen zweiten Schritt fehlen in deinem Beitrag Konfiguration und Logs. Schreibst du den Beitrag von Hand auf GitHub, kannst du dort jeden Abschnitt einzeln über **Kopieren** übernehmen. > **Beiträge sind öffentlich** > > Wir ersetzen Passwörter, Tokens und andere vertrauliche Werte automatisch durch `*****`. Prüfe deinen Beitrag trotzdem auf persönliche Daten, bevor du ihn auf GitHub abschickst. ## Logs besorgen Die Logs-Seite zeichnet immer alle Level bis `trace` auf. Du musst dafür weder die Konfiguration ändern noch neu starten. 1. Öffne **Mehr → Logs**. 2. Wähle das Level **TRACE** und die Bereiche des betroffenen Ladepunkts und der betroffenen Geräte. ![Logs-Seite gefiltert nach Level TRACE und Bereich lp-1](/_astro/logs-de-light-1x.CY_bCoyn.webp) Logs-Seite gefiltert nach Level TRACE und Bereich lp-1 3. Stelle das Problem nach. Starte bei Verbindungsproblemen (z. B. OCPP, EEBus, Modbus) deine Instanz vorher neu, damit das Log alles ab dem Start enthält. 4. Klicke auf das Symbol zum Herunterladen, sobald das Problem aufgetreten ist. Die Datei enthält die Einträge des gewählten Levels und der gewählten Bereiche. 5. Ziehe die Datei in deinen Beitrag auf GitHub, um sie anzuhängen. Das Log sollte beginnen, bevor das Problem entsteht, und reichen, bis es sichtbar ist. So lässt sich nachvollziehen, wie es dazu kam. Die Logs-Seite behält die letzten 10.000 Einträge. Das entspricht je nach Installation etwa 30 bis 90 Minuten. Bei einem Neustart gehen sie verloren. Für längere Zeiträume gibt es die [Langzeit-Logs](#system-logs). Standardmäßig zeigt die Logs-Seite das Level `debug` mit den Entscheidungen der Regelung. `trace` enthält zusätzlich die vollständige Kommunikation mit Geräten und Diensten. ## Langzeit-Logs Die Logs-Seite deckt nur einen begrenzten Zeitraum ab. Brauchst du mehr Daten, einen längeren Zeitraum oder Einträge aus der Zeit vor einem Neustart, nutze die Logs deines Systems. Sie helfen auch, wenn die Weboberfläche nicht erreichbar ist. Diese Logs enthalten nur Einträge des eingestellten Levels, standardmäßig `info`. Erhöhe das Level, bevor du das Problem nachstellst. ### Log-Level erhöhen Das Level legst du in der Konfigurationsdatei `evcc.yaml` fest, allgemein und für einzelne Bereiche. Im Beispiel gilt allgemein `debug` und für den ersten Ladepunkt `trace`. Wie deine Bereiche heißen, siehst du im Bereichsfilter der [Logs-Seite](#logs). **evcc.yaml** ```yaml log: debug levels: lp-1: trace ``` Gibt es die Datei noch nicht, lege sie mit genau diesen Zeilen an. Deine Konfiguration aus der Weboberfläche bleibt davon unberührt. Stelle das Level wieder zurück, sobald du das Log hast, denn `trace` erzeugt sehr viele Daten. ### Logs je Installation Wo die Logs liegen und welche Datei du anpasst, hängt von deiner Installation ab. Öffne den passenden Abschnitt. Raspberry Pi & Co. (evcc Linux Image) Öffne [Cockpit](/de/installation/linux-image#cockpit) unter `https://evcc.local:9090`. Dateien bearbeitest du im **Navigator**, Befehle führst du im **Terminal** aus. Trage das Log-Level in `/etc/evcc.yaml` ein und starte neu: ```sh sudo systemctl restart evcc ``` Einträge der letzten Stunde anzeigen: ```sh sudo journalctl -u evcc --since "1 hour ago" --no-pager ``` Log fortlaufend anzeigen: ```sh sudo journalctl -fau evcc ``` Bestimmten Zeitraum anzeigen: ```sh sudo journalctl -u evcc -S "2026-03-21 07:00" -U "2026-03-21 08:00" --no-pager ``` Kopiere die Ausgabe aus dem Terminal in deinen Beitrag. Docker Trage das Log-Level in deine `compose.yml` ein, wenn du Docker Compose nutzt, oder in die `evcc.yaml`, die du in den Container eingebunden hast. * compose.yml ```yaml services: evcc: environment: - EVCC_LOG=debug,lp-1:trace ``` Container neu erstellen: ```sh docker compose up -d ``` * evcc.yaml ```yaml log: debug levels: lp-1: trace ``` Container neu starten: ```sh docker restart evcc ``` Alle Einträge des Containers mit dem Namen `evcc` anzeigen: ```sh docker logs evcc ``` Log fortlaufend anzeigen: ```sh docker logs -f --since 10m evcc ``` Einträge der letzten Stunde anzeigen: ```sh docker logs --since 1h evcc ``` Kopiere die Ausgabe aus dem Terminal in deinen Beitrag. Mit Docker Compose lautet der Befehl `docker compose logs evcc`, ausgeführt im Ordner deiner `compose.yml`. Docker-Oberflächen (z. B. Synology, QNAP, Portainer, Unraid) zeigen das Log in den Details des Containers. Wird der Container neu erstellt, geht sein Log verloren. Wie du Logs dauerhaft speicherst, steht in der Dokumentation deiner Docker-Oberfläche. Home Assistant Trage das Log-Level in `/addon_configs/49686a9f_evcc/evcc.yaml` ein. Im Tab **Konfiguration** der App muss `config_file` auf `/config/evcc.yaml` stehen. Starte die App danach neu. Wie du die Datei bearbeitest, steht unter [Konfigurationsdatei](/de/installation/home-assistant). Die Logs findest du in Home Assistant unter **Einstellungen → Apps → evcc** im Tab **Protokoll**. Proxmox Öffne die Konsole des Containers in Proxmox. Trage das Log-Level in `/etc/evcc.yaml` ein und starte neu: ```sh sudo systemctl restart evcc ``` Einträge der letzten Stunde anzeigen: ```sh sudo journalctl -u evcc --since "1 hour ago" --no-pager ``` Log fortlaufend anzeigen: ```sh sudo journalctl -fau evcc ``` Bestimmten Zeitraum anzeigen: ```sh sudo journalctl -u evcc -S "2026-03-21 07:00" -U "2026-03-21 08:00" --no-pager ``` Kopiere die Ausgabe aus dem Terminal in deinen Beitrag. Linux Trage das Log-Level in `/etc/evcc.yaml` ein und starte neu: ```sh sudo systemctl restart evcc ``` Einträge der letzten Stunde anzeigen: ```sh sudo journalctl -u evcc --since "1 hour ago" --no-pager ``` Log fortlaufend anzeigen: ```sh sudo journalctl -fau evcc ``` Bestimmten Zeitraum anzeigen: ```sh sudo journalctl -u evcc -S "2026-03-21 07:00" -U "2026-03-21 08:00" --no-pager ``` Kopiere die Ausgabe aus dem Terminal in deinen Beitrag. macOS Wenn du mit Homebrew installiert und den launchd-Agent wie unter [macOS](/de/installation/macos) beschrieben angelegt hast, wird das Log in eine Datei geschrieben. Trage das Log-Level in `/etc/evcc.yaml` ein und starte neu: ```sh launchctl kickstart -k gui/$(id -u)/io.evcc ``` Logs anzeigen: ```sh tail -f "$(brew --prefix)/var/log/evcc.log" ``` FreeBSD Trage das Log-Level in `/usr/local/etc/evcc.yaml` ein und starte neu: ```sh service evcc restart ``` Log fortlaufend anzeigen: ```sh tail -f /var/log/evcc.log ``` Windows Trage das Log-Level in die `evcc.yaml` im Ordner der `evcc.exe` ein und starte den Dienst neu. Der Dienst muss mit dem Argument `-c evcc.yaml` gestartet werden. Logdateien gibt es nur, wenn du die Ausgabeumleitung im Tab **I/O** des [Hintergrunddienstes](/de/installation/windows#nssm) eingerichtet hast. Ohne Dienst startest du das Programm in einem Terminalfenster und siehst die Ausgabe dort. ## Funktionswünsche Ein Gerät oder eine Funktion fehlt? Die Community ist groß, gut möglich also, dass schon jemand eine ähnliche Idee hatte. Nimm dir etwas Zeit zum Stöbern, bevor du deinen Wunsch als [Issue](https://github.com/evcc-io/evcc/issues/new/choose) einreichst. Auf GitHub heißt die passende Vorlage *Feature request*. * **Nachschauen**: Schau in den [Discussions](https://github.com/evcc-io/evcc/discussions) und den [geschlossenen Issues](https://github.com/evcc-io/evcc/issues?q=is%3Aissue+is%3Aclosed) nach, ob es das Thema schon einmal gab. * **Wieder aufgreifen ist in Ordnung**: Seit der letzten Diskussion kann sich einiges geändert haben. * **Was und warum**: Beschreibe, was du erreichen möchtest, und nicht nur die Lösung, die dir vorschwebt. * **Neue Geräte**: Nenne das genaue Gerät und hänge die API-Dokumentation oder das Datenblatt des Herstellers an. Stell dich darauf ein, mit deinem eigenen Gerät zu testen.