Mealie Atelier Fehlerbehebung: Karte, Verbindung und Sync

Dieser Guide sammelt die Fehlerbilder, die bei Mealie Atelier auftauchen können, geordnet nach dem, was du siehst. Die Einrichtung selbst steht im Einrichtungs-Guide. Die Meldungen unten stammen aus der deutschen Oberfläche der Karten.

Bevor du suchst: Bei jedem Problem hilft ein Blick ins Protokoll unter Einstellungen → System → Protokolle, wie im Troubleshooting-Guide beschrieben. Zusätzlich kannst du die Diagnosedaten der Integration herunterladen. Sie verbergen Zugangsdaten und enthalten Zahlen statt Inhalte.

Die Karte fehlt oder wird nicht gefunden

Das Dashboard zeigt statt der Karte einen Fehler, oder die Karte taucht beim Hinzufügen nicht auf. Dann fehlt meistens die Ressource oder der Browser hat noch eine alte Version im Cache.

• Prüfe in HACS, ob Mealie Atelier Cards mit dem Typ Dashboard installiert ist. Die Bridge hat den Typ Integration, die beiden werden gern verwechselt.
• Auf Dashboards, die du in der Oberfläche verwaltest, wird die Ressource automatisch angelegt. Bei einem Dashboard im YAML-Modus musst du sie selbst eintragen: /local/community/mealie-atelier-cards/mealie-atelier-cards.js mit dem Typ module.
• Lade den Browser hart neu (Strg+F5) oder leere in der Companion App den Frontend-Cache. Das gilt für alle Karten aus HACS, mehr dazu im HACS-Guide.

Meldung: Bitte zuerst „Mealie Atelier Bridge“ in Home Assistant konfigurieren

Die Karte meldet „Verbindung nicht eingerichtet“ oder „Mealie Atelier ist noch nicht eingerichtet“. Die Karte findet also keine Verbindung zu Mealie. Prüfe unter Einstellungen → Geräte & Dienste, ob die Bridge (oder die eingebaute Mealie-Integration) dort mit einem Eintrag steht. Hast du die Bridge frisch heruntergeladen, fehlt vielleicht noch der Neustart von Home Assistant.

Die Karte kann auch mit der eingebauten Mealie-Integration allein arbeiten. Dann fehlen allerdings Fotos, Bearbeitung und Einkauf. Die Karte weist darauf hin, wenn eine Funktion die Bridge braucht.

Verbindungsfehler beim Einrichten

Home Assistant prüft die Verbindung schon im Formular. Scheitert das, liegt es fast immer an der Adresse:

• Die Adresse muss mit http:// oder https:// beginnen und den Port enthalten, zum Beispiel http://mealie.example:9000.
• Keine Adresse mit Login- oder API-Pfad, keine Zugangsdaten in der URL.
• Keine Ingress-Adresse. Nutzt du die Mealie-App für Home Assistant, verwende die direkte Adresse mit Port 9090. Das gilt auch für die offizielle Mealie-Integration, deren Doku den Port 9090 nennt und vor der Ingress-Adresse mit der Endung /xxx_mealie warnt.
• Home Assistant muss die Adresse selbst erreichen können, es genügt nicht, dass dein Rechner sie sieht.
• Bei HTTPS mit selbst signiertem Zertifikat schlägt die TLS-Prüfung fehl. Schalte „TLS-Zertifikat prüfen“ nur in einem vertrauenswürdigen Heimnetz aus.

Später, im laufenden Betrieb, erscheint „Mealie ist nicht erreichbar oder hat unerwartet geantwortet. Versuche es gleich noch einmal.“ Dann ist Mealie kurz weg, zum Beispiel beim Neustart, oder die Adresse hat sich geändert. Passe sie über Neu konfigurieren an der Integration an.

Token abgelehnt

Meldung: „Mealie hat den Zugriffstoken abgelehnt. Prüfe den Token in den Einstellungen.“ Home Assistant fragt dann nach einer neuen Anmeldung.

• Erstelle in Mealie unter Benutzerprofil → API-Token einen neuen Token und trage ihn über die erneute Anmeldung oder Neu konfigurieren ein.
• Der Token braucht die Rechte des Kontos für die Funktionen, die du nutzen willst. Ein Konto mit wenig Rechten in Mealie kann auch über die Bridge nicht mehr.
• Beim Neukonfigurieren wird ein Token von einem anderen Mealie-Konto abgelehnt, weil Timer und Studiodaten pro Eintrag gespeichert sind. Willst du ein anderes Konto nutzen, richte die Integration neu ein.
• Der Token gehört nie in die Karten-YAML. Hast du ihn öffentlich gepostet, lösche ihn in Mealie und erstelle einen neuen.

Schreibfreigaben und Nur-Lesen-Modus

Du kannst Rezepte lesen, aber nichts ändern. Dafür gibt es mehrere Gründe mit jeweils eigener Meldung:

• „Diese Küche ist schreibgeschützt, daher lässt sich nichts ändern.“ Der Nur-Lesen-Modus der Bridge ist an. Du schaltest ihn in den Optionen der Integration aus. Er schlägt jede Schreibfreigabe.
• „Dein Home-Assistant-Konto darf diese Küche ansehen, aber nicht ändern.“ oder „Du darfst in dieser Küche keine Daten ändern.“ Dein Nutzer steht nicht in der Option Nutzer mit Schreibrecht. Ein Administrator kann ihn dort ergänzen. Ist die Liste leer, dürfen alle Nutzer schreiben.
• „Diese Aktion erfordert Administratorrechte.“ oder „Rezeptänderungen benötigen Home-Assistant-Adminrechte.“ Rezepte bearbeiten dürfen nur Administratoren. Das ist auch mit Freigabe so.
• „Diese Funktion ist in den Einstellungen abgeschaltet.“ Das betrifft vor allem die experimentelle strukturierte Zutatenbearbeitung. Ein Administrator aktiviert sie in den Optionen, am besten nach einem Mealie-Backup.

Kochtimer und Journal-Einträge sind persönlich und werden nur vom Nur-Lesen-Modus gesperrt.

Rezeptänderungen und Backups

• „Das Rezept wurde anderswo geändert. Lade es vor dem Speichern neu.“ Jemand hat das Rezept zwischenzeitlich in Mealie geändert. Lade es neu, damit du nichts überschreibst.
• „Mealie hat die Änderung angenommen, aber das gespeicherte Rezept sieht anders aus. Prüfe das Rezept, bevor du es erneut versuchst.“ Schau dir das Rezept in Mealie an, bevor du es noch einmal speicherst.
• „Die Sicherung konnte nicht geschrieben werden, daher wurde nichts geändert.“ Die Bridge speichert vor jeder Rezeptänderung eine Sicherung. Gelingt das nicht, ändert sie nichts in Mealie.

Die Bridge hält die jeweils letzten 10 Sicherungen pro Rezept für bis zu 200 Rezepte vor. Titelfotos liegen dazu als private Dateien unter mealie_atelier/backups/ im Konfigurationsordner (jeweils die letzten 3 pro Rezept). Entfernst du die Integration, werden die Sicherungen gelöscht.

Fotos

Fotos und das Hochladen brauchen die Bridge. Mit der eingebauten Integration allein gibt es keine Fotos.

• „Das Foto wurde abgelehnt. Nutze ein JPEG-, PNG- oder WebP-Bild innerhalb der Größenbeschränkung.“ Erlaubt sind JPEG, PNG und WebP mit höchstens 10 MiB.
• „Das Hochladen von Fotos braucht eine sichere Verbindung (HTTPS).“ Öffne Home Assistant über HTTPS.
• „Der Upload ist abgelaufen. Starte ihn erneut.“ und „Es sind zu viele Uploads offen. Warte einen Moment und versuche es erneut.“ Hier hilft einfach ein neuer Versuch.
• Große Fotos kommen seit Bridge 0.10.0 vollständig an. Wurde bei dir ein großes Foto abgeschnitten, aktualisiere die Bridge.

Entfernst du ein Schrittfoto im Editor, bleibt die Datei auf dem Speicher von Mealie liegen, weil Mealie keinen Befehl zum Löschen von Rezept-Dateien hat. Das Foto wird nur vom Schritt und aus der Liste der Dateien entfernt. Bei Titelfotos ist das anders: Sie werden in Mealie gelöscht, nachdem eine Sicherungskopie entstanden ist, sodass der Versionsverlauf sie zurückholen kann.

Offline-Warteschlange

Ohne Verbindung merkt sich die Karte Einkaufsänderungen auf dem Gerät. Die Meldung dazu lautet: „Keine Verbindung. Deine Änderung ist auf diesem Gerät gespeichert und wird später gesendet.“ In der Statusleiste siehst du, wie viele Änderungen warten. Mit Jetzt senden stößt du die Übertragung an. Einträge, die scheitern, bleiben sichtbar und lassen sich verwerfen.

Weitere Meldungen im Zusammenhang mit Offline:

• „Aktiviere zuerst den Offline-Einkauf über die Statusleiste.“ Die Funktion ist standardmäßig aus. Sie speichert Einkaufslisten auf dem Gerät, aktiviere sie deshalb nicht auf öffentlichen Geräten.
• „Noch keine Offline-Kopie. Öffne die Einkaufsliste einmal online.“ und „Lade die Einkaufsliste zuerst bei bestehender Verbindung.“ Die Karte braucht erst einmal eine Online-Kopie der Liste.
• „Eine vorgemerkte Änderung wurde verworfen, weil dein Konto diese Küche nicht mehr ändern darf.“ Deine Freigabe wurde in der Zwischenzeit entzogen.
• „Dieser Eintrag wurde zwischenzeitlich anderswo geändert. Verwirf deine Änderung und prüfe die Liste.“ Jemand hat denselben Artikel in Mealie geändert. Bevor die Karte etwas überschreibt, fragt sie dich. Schau auf die aktuelle Mealie-Liste und verwirf dann deine Änderung.
• „Dieser Eintrag steht womöglich schon auf der Liste. Prüfe die Liste und verwirf dann diesen Eintrag.“ Das passiert, wenn unklar ist, ob ein neuer Eintrag schon angekommen ist. Die Bridge protokolliert jede Operation vor dem Schreiben, damit ein erneutes Senden keinen Eintrag doppelt anlegt. Bei Unsicherheit entscheidest du.
• „Diese vorgemerkte Änderung kollidiert mit einer früheren. Verwirf sie und mache die Änderung neu.“
• „Web Push benötigt HTTPS und einen unterstützten Browser.“ und „Benachrichtigungen wurden nicht erlaubt.“ Das betrifft die Hintergrund-Timer. Ohne Serververbindung lässt sich außerdem kein Hintergrundalarm aktivieren.

Der Button „Lokale Daten löschen“ entfernt Einkaufslisten und noch nicht gesendete Änderungen unwiderruflich vom Gerät.

Smart Shopping Sync

Der Sync-Status der Regel zeigt dir, was los ist. Die häufigsten Fälle:

• „Der Einkaufs-Sync braucht Home Assistant mit der Mealie Atelier Bridge.“ Ohne Bridge oder in der eigenständigen Web-App gibt es keinen Sync.
• „Diese Regel hat ihren ersten Stapel noch nicht gesendet. Bestätige den ersten Stapel zuerst in der Einrichtung.“ Vor der Bestätigung läuft nichts automatisch. Öffne die Vorschau und sende den ersten Stapel.
• „Diese Liste kann nicht als Ziel dienen. Wähle eine To-do-Liste, die das Hinzufügen von Artikeln unterstützt und keine Mealie-Liste ist.“ Das Ziel muss eine To-do-Liste sein, in die man Artikel einfügen kann. Listen der eingebauten Mealie-Integration sind als Ziel gesperrt.
• „Eine andere Regel nutzt diese Quellliste bereits.“ Pro Mealie-Liste gibt es eine Regel. Bearbeite die vorhandene.
• „Du kannst höchstens 5 Sync-Regeln haben. Lösche zuerst eine.“
• „Dein Home-Assistant-Nutzer darf den Sync ansehen, aber nicht ändern.“ Regeln legen Administratoren an.

Ziel oder Mealie nicht erreichbar: „Zielliste nicht erreichbar“ bedeutet, dass die Artikel in Mealie offen bleiben. Bei „Mealie nicht erreichbar“ wurde nichts gesendet. Prüfe die Verbindung der Integration, die die Zielliste liefert, etwa Bring!.

Fehlgeschlagene Artikel: Lehnt die Zielliste einen Artikel ab oder antwortet sie nicht rechtzeitig, bleibt er in Mealie offen und gilt als fehlgeschlagen. Mit Fehlgeschlagene erneut versuchen startest du einen neuen Versuch.

Unsichere Zustellung: Der Status „Unklar, ob angekommen“ erscheint, wenn die Zielliste nicht rechtzeitig antwortet und die Bridge nicht sagen kann, ob der Artikel angekommen ist. Die Bridge liest vor dem erneuten Senden die Zielliste und gleicht ab. Lässt sich das nicht klären, wartet der Artikel auf deine Entscheidung, damit kein Duplikat entsteht. Das passiert auch, wenn mehrere Artikel in der Zielliste passen: „Mehrere Artikel in der Zielliste passen. Entscheide, ob du ihn erneut sendest.“ Eine Zustellung genau einmal lässt sich bei Anbietern ohne Idempotenzschlüssel nicht garantieren. Zugesagt sind sichtbare Unsicherheit, ein Abgleich und kein stilles Abhaken in Mealie.

Konflikte: „Nach dem Senden geändert“ oder „Nach dem Senden entfernt“ heißt, dass du einen Artikel in Mealie bearbeitet oder gelöscht hast, nachdem er gesendet wurde. Die Zielliste wird nie automatisch geändert oder aufgeräumt. Du wählst Verwerfen (das Ziel bleibt, wie es ist) oder Erneut senden. Hatte eine Verschieben-Regel den Artikel schon in Mealie abgehakt, übernimmt Verwerfen den aktuellen Mealie-Stand und hakt nicht noch einmal ab.

Vergangene Läufe siehst du im Verlauf unter „Letzte Läufe“. Er zeigt Zeit, Ergebnis und Anzahl, aber nie den Text der Artikel.

Wo du Hilfe bekommst

Für Einrichtungsfragen und Ideen sind die GitHub Discussions der richtige Ort. Einen reproduzierbaren Fehler meldest du als Issue im jeweiligen Repository, bei der Bridge oder bei den Karten. Häng dort die Diagnosedaten der Integration an, nie aber API-Tokens, private Rezeptdaten oder sensible Protokolle. Sicherheitslücken meldest du über den privaten Weg aus der SECURITY.md der Repositories.

Mehr Hintergrund liefern der Überblick und der Mealie-Guide. Und wenn dein Problem hier fehlt: Erzähl in den Discussions, was bei dir passiert ist, damit die Liste wächst.