Mealie: der selbst gehostete Rezeptmanager

Was ist Mealie?

Mealie ist ein selbst gehosteter Rezeptmanager und Essensplaner. Du gibst die Adresse eines Rezepts im Netz ein, Mealie liest die Daten aus und speichert sie in deiner eigenen Sammlung. Eigene Familienrezepte legst du im Editor an. Dazu kommen ein Wochenplan und Einkaufslisten, die sich aus den Zutaten deiner Rezepte füllen.

Für Home Assistant ist das aus zwei Gründen interessant. Mealie hat eine REST-API, an die sich andere Programme hängen können. Und Home Assistant bringt eine eigene Integration dafür mit. Damit landen dein Wochenplan in Kalendern und deine Einkaufslisten als To-do-Listen im Smart Home.

In diesem Guide richten wir Mealie ein und verbinden es mit Home Assistant. Wie du daraus ein schönes Küchen-Dashboard machst, zeigt der Folge-Guide Mealie Atelier.

Mealie installieren

Die Mealie-Doku empfiehlt Docker mit dem fertigen Image aus der GitHub-Registry. Zwei Datenbanken stehen zur Wahl. SQLite ist die Vorgabe und reicht laut Doku für Installationen bis etwa 20 Nutzer mit lokalem Speicher. PostgreSQL brauchst du bei Netzwerkspeicher, vielen gleichzeitigen Nutzern oder wenn du die unscharfe Suche willst. Für ein Zuhause ist SQLite normalerweise die richtige Wahl.

Die Doku warnt allerdings: Liegt der Datenordner auf einem Netzwerkspeicher (NAS), nimm PostgreSQL. SQLite kann dort zu beschädigten Daten oder gesperrten Datenbanken führen.

Eine minimale docker-compose.yaml mit SQLite sieht so aus (angelehnt an das Beispiel aus der Mealie-Doku):

1services:
2  mealie:
3    image: ghcr.io/mealie-recipes/mealie:vX.Y.Z
4    container_name: mealie
5    restart: always
6    ports:
7      - "9925:9000"
8    deploy:
9      resources:
10        limits:
11          memory: 1000M
12    volumes:
13      - mealie-data:/app/data/
14    environment:
15      ALLOW_SIGNUP: "false"
16      PUID: 1000
17      PGID: 1000
18      TZ: Europe/Berlin
19      BASE_URL: https://mealie.deinedomain.de
20volumes:
21  mealie-data:

Ein paar Hinweise dazu:

• Ersetze vX.Y.Z durch die aktuelle Version aus dem Mealie-Repository (das Badge „latest release“ oben im README). Die Entwickler raten zu einem festen Versions-Tag statt latest, damit du bewusst updatest und vorher die Release Notes liest.
• Das Webinterface lauscht im Container auf Port 9000. Hier landet es auf Port 9925 deines Servers, den Wert kannst du frei wählen.
• Das Speicherlimit empfiehlt die Doku ausdrücklich, weil Python sonst auf Rechnern mit viel RAM mehr Speicher reserviert als nötig.
• BASE_URL und die SMTP-Einstellungen (für Einladungen und Passwort-Resets) solltest du laut Checkliste setzen.

Gestartet wird mit docker compose up -d. Danach erreichst du Mealie unter http://localhost:9925 bzw. der Adresse deines Servers. Die Doku nennt als Standard-Zugang changeme@example.com mit dem Passwort MyPassword. Ändere beides direkt nach dem ersten Login. Unter /admin/site-settings zeigt dir Mealie außerdem, ob die Konfiguration passt.

Die Images gibt es für linux/amd64 und linux/arm64. Auf 32-Bit-ARM, etwa einem Raspberry Pi mit 32-Bit-System, läuft Mealie laut Doku nicht.

Mealie als App in Home Assistant

Wenn du Home Assistant OS nutzt, gibt es eine zweite Möglichkeit: die Mealie-App für Home Assistant, früher Add-on genannt. Dann läuft Mealie direkt auf dem Gerät, auf dem auch Home Assistant läuft. Die offizielle Integrationsdoku nennt dazu einen wichtigen Punkt: Die App ist unter Port 9090 erreichbar. Für die Anbindung brauchst du diese direkte Adresse mit Port, also zum Beispiel http://192.168.1.20:9090. Die Ingress-Adresse, die auf /xxx_mealie endet, funktioniert für die Integration nicht.

Docker oder App? Die App ist bequemer, weil alles an einem Ort liegt. Mit Docker kannst du Mealie unabhängig von Home Assistant betreiben, aktualisieren und sichern. Beides taugt als Grundlage für alles Weitere.

Die ersten Schritte in Mealie

Bevor Home Assistant ins Spiel kommt, lohnt sich ein Rundgang durch Mealie selbst.

Rezepte importieren: Mealie kann Rezepte aus unzähligen Webseiten über deren Adresse einlesen. Alternativ fügst du strukturiertes HTML oder JSON ein oder tippst ein Rezept von Hand im Editor ein. Wer von einer anderen App kommt, findet unter /group/migrations Importe für Tandoor, Nextcloud Cookbook, Paprika, Chowdown, Plan to Eat, Recipe Keeper und weitere.

Wochenplan: Der Planer zeigt standardmäßig den Vortag und die nächsten sechs Tage. Du wählst Rezepte für die Tage, lässt Mealie ein zufälliges Rezept vorschlagen oder legst eine Notiz an, zum Beispiel für Reste oder „Pizza bestellen“. Jedes geplante Rezept hat eine eigene Portionszahl, die sich später in der Einkaufsliste niederschlägt.

Einkaufslisten: Du fügst Artikel von Hand hinzu oder übernimmst alle Zutaten eines Rezepts. Mit Labels sortierst du die Liste, etwa nach Supermarkt-Abteilung. Ein versehentlich abgehakter Artikel lässt sich unter „abgehakte Artikel“ wieder aktivieren.

Haushalte: Mealie trennt zwischen Gruppen und Haushalten. Eine Gruppe ist eine komplett abgeschottete Instanz. Haushalte innerhalb einer Gruppe teilen sich die Rezepte, haben aber eigene Wochenpläne und Einkaufslisten. Das ist praktisch, wenn zum Beispiel zwei Familien eine Rezeptsammlung nutzen, aber getrennt einkaufen.

Backups: Mealie legt keine automatischen Backups mehr an. Unter den Admin-Einstellungen erzeugst du Sicherungen als ZIP-Datei. Die Doku betont, dass du sie außerhalb des Servers aufbewahren musst. Mach also schon vor den ersten Experimenten eine Sicherung, vor allem bevor später Rezepte über Home Assistant bearbeitet werden.

API-Token anlegen

Home Assistant (und später auch Mealie Atelier) greift über die API auf Mealie zu. Dafür brauchst du einen API-Token:

1. In Mealie anmelden und dein Benutzerprofil öffnen
2. API-Token öffnen (die Seite hat die Adresse /user/profile/api-tokens)
3. Einen sprechenden Namen vergeben, zum Beispiel „Home Assistant“
4. Generate wählen
5. Den angezeigten Token kopieren, damit du ihn gleich in Home Assistant einfügen kannst

Leg dir pro Programm einen eigenen an, dann kannst du später genau den einen löschen, den du nicht mehr brauchst.

Die Mealie-Integration in Home Assistant

Home Assistant hat Mealie als offizielle Integration an Bord. Laut Doku werden Mealie-Instanzen ab Version 3.2.0 unterstützt.

So fügst du sie hinzu: Einstellungen → Geräte & Dienste → Integration hinzufügen → Mealie. Dann trägst du drei Dinge ein:

• die URL deiner Mealie-Installation (bei der App mit Port 9090, siehe oben)
• den API-Token
• ob das SSL-Zertifikat geprüft werden soll. Lass das aktiv, außer Mealie nutzt ein selbst signiertes Zertifikat

Was du danach bekommst:

• Für jede Mahlzeitenart des Wochenplans einen Kalender: Frühstück, Mittagessen, Abendessen, Beilage, Dessert, Getränk und Snack. Sie werden einmal pro Stunde aktualisiert.
• Für jede Einkaufsliste in Mealie eine To-do-Liste in Home Assistant, aktualisiert alle 5 Minuten.
• Sensoren für Statistiken wie die Zahl der Rezepte, Kategorien, Tags, Küchengeräte und Nutzer. Sie aktualisieren alle 15 Minuten.
• Aktionen, die du in Automationen oder Skripten nutzt: Rezepte suchen und abrufen, Rezepte per URL importieren, Einkaufslisten-Einträge abrufen sowie Wochenplan-Einträge setzen, ändern, löschen oder zufällig füllen.

Die Doku nennt auch gleich ein paar Ideen: Wochenplan im Kalender anschauen, per Automation oder Sprachassistent etwas auf die Einkaufsliste setzen oder mit einer Zone erinnert werden, wenn du dich einem Geschäft näherst und noch Artikel offen sind.

Eine Einschränkung steht ebenfalls in der Doku: Wenn du in der Einkaufsliste einen Eintrag mit Zutat bearbeitest, wird er zu einem reinen Notiz-Eintrag.

Wegen des 5-Minuten-Takts erscheinen Änderungen aus Mealie nicht sofort in der To-do-Liste. Für ein Dashboard mit schnellen Reaktionen gibt es einen anderen Weg, den ich im nächsten Guide zeige.

Falls etwas nicht klappt, empfiehlt die Doku vor einer Fehlermeldung das Debug-Logging einzuschalten, die Integration neu zu starten und die Diagnosedaten herunterzuladen. Wie du dort vorgehst, steht auch im Troubleshooting-Guide. Wenn du die Integration wieder entfernst, kannst du den Token in Mealie unter API-Token löschen.

Wie geht es weiter?

Die eingebaute Integration liefert Kalender, To-do-Listen und Sensoren, aber kein Küchen-Dashboard. Dafür gibt es Mealie Atelier: Dashboard-Karten mit Kochmodus, Wochenplaner und Einkaufsliste, dazu eine optionale Integration für Schreibzugriffe.

Falls du Karten und Integrationen über den Community-Store installierst, hilft dir der HACS-Guide weiter. Dort steht auch, dass HACS ab Home Assistant 2026.11 zum Home Assistant Marketplace wird.

Nutzt du Mealie schon, oder suchst du noch den passenden Rezeptmanager für dein Smart Home? Schreib mir gern in die Kommentare, wie du es einsetzt.