Mealie auf einem VPS selbst hosten
Installieren Sie Mealie mit Docker Compose auf einem eigenen VPS. Importieren Sie Rezepte per Link und nutzen Sie Essensplan, Einkaufsliste, nginx, TLS und Backups.
Was ein selbst gehosteter Rezeptmanager leistet
Ein selbst gehosteter Rezeptmanager speichert Ihre Rezepte in einer Datenbank auf einem Server, den Sie selbst verwalten. Mealie ist die Lösung, für die sich die meisten Haushalte entscheiden. Sie fügen die Adresse einer Rezeptseite ein. Mealie liest daraus die Zutaten, die Zubereitungsschritte, die Anzahl der Portionen und die Zubereitungszeit. Den Beschreibungstext und die Werbung lässt es dabei außen vor. In Ihrer Sammlung landet nur das Rezept.
Der restliche Funktionsumfang der Anwendung ist überschaubar. Es gibt einen Wochenplan, in den Sie Rezepte per Drag-and-drop einfügen. Außerdem gibt es eine Einkaufsliste, die aus diesem Plan erstellt wird. Jede Person, die kocht, erhält ein eigenes Login. Die gesamte Anwendung läuft in einem Container. Zwischen Anfragen ist sie inaktiv. Deshalb reicht ein kleiner VPS aus.
Diese Anleitung verwendet Docker Compose. Wenn Ihnen die Begriffe services: und volumes: noch nicht bekannt sind, lesen Sie zuerst wie Docker-Compose-Dateien aufgebaut sind. Der gesamte folgende Inhalt besteht aus einer Compose-Datei und vier Befehlen.
Mealie mit Docker Compose installieren
Mealie veröffentlicht seine Images in der GitHub Container Registry. Am 18 November 2026 ist der aktuelle stabile Tag v3.31.0, der am 13 November veröffentlicht wurde. Diese Version enthält Sicherheitskorrekturen. Das Projekt empfiehlt allen, zu aktualisieren. Verwenden Sie eine feste Version statt latest. Mit latest kann ein docker compose pull an einem beliebigen Tag Sie auf eine Datenbankmigration bringen, auf die Sie nicht vorbereitet waren.
sudo mkdir -p /srv/mealie
cd /srv/mealie
sudo nano docker-compose.ymlservices:
mealie:
image: ghcr.io/mealie-recipes/mealie:v3.31.0
container_name: mealie
restart: always
ports:
- "127.0.0.1:9925:9000"
deploy:
resources:
limits:
memory: 1000M
volumes:
- mealie-data:/app/data/
environment:
ALLOW_SIGNUP: "false"
PUID: 1000
PGID: 1000
TZ: Europe/Amsterdam
BASE_URL: https://recipes.example.com
volumes:
mealie-data:Vor dem Start sollten Sie zwei Zeilen prüfen.
Der Port ist als 127.0.0.1:9925:9000 und nicht als 9925:9000 angegeben. Der Container lauscht intern auf 9000. Der Host leitet 9925 darauf weiter. Wenn diese Zuordnung an die Loopback-Adresse gebunden ist, kann Nginx Mealie erreichen, das Internet jedoch nicht. Docker schreibt eigene Regeln in den Paketfilter. Deshalb ist ein einfacher 9925:9000 von außen erreichbar, selbst wenn Ihre Firewall den Port als geschlossen meldet. Dieses unerwartete Verhalten sollten Sie einmal verstehen: warum veröffentlichte Docker-Ports ufw ignorieren.
BASE_URL muss exakt die öffentliche Adresse sein, die Sie verwenden werden, einschließlich Schema und ohne abschließenden Schrägstrich. Mealie erstellt daraus Links zum Zurücksetzen von Passwörtern und Einladungslinks. Wenn Sie http://localhost:9925 setzen, enthält die Einladung an Ihren Partner einen Link, der nur auf dem Server selbst funktioniert.
Starten Sie den Dienst und überwachen Sie den ersten Start.
sudo docker compose up -d
sudo docker compose logs -f mealieBeim ersten Start erstellt Mealie die SQLite-Datenbank und führt die Migrationen aus. Das dauert einige Sekunden. Sobald das Log zur Ruhe kommt und keine Migrationszeilen mehr ausgibt, prüfen Sie die Anwendung lokal.
curl -I http://127.0.0.1:9925Ein 200 OK bedeutet, dass die Anwendung läuft. Wenn Sie Connection refused erhalten, führen Sie sudo docker compose ps -a aus, um den Status und den Exit-Code des Containers zu prüfen. Ein Container, der mit Code 137 beendet wurde, hat SIGKILL erhalten. Dieser Code allein zeigt nicht, dass das 1000M-Speicherlimit überschritten wurde. Auch das manuelle Beenden des Containers erzeugt diesen Code.
Erste Anmeldung und Deaktivieren der offenen Registrierung
Das Standardkonto lautet changeme@example.com und das Passwort lautet MyPassword. Melden Sie sich damit an und ändern Sie anschließend beides sofort, weil diese Kombination in der Dokumentation steht und daher in jedem Scanner enthalten ist.
ALLOW_SIGNUP: "false" in der Compose-Datei ist beabsichtigt. Bei geöffneter Registrierung kann jeder, der die Adresse findet, ein Konto in Ihrer Rezeptverwaltung erstellen. Bei deaktivierter Registrierung fügen Sie Personen über den Administrationsbereich hinzu. Dabei wird ein Einladungslink erzeugt, den Sie selbst versenden. Dieser Link wird aus BASE_URL erstellt. Deshalb ist dieser Wert wichtig. Wenn Sie mehrere Anwendungen auf demselben Server betreiben und für alle dasselbe Passwort verwenden möchten, kann Mealie die Anmeldung an einen externen Identitätsanbieter wie eine selbst gehostete Authentik-Instanz übergeben.
Mealie ordnet Benutzer einem Haushalt zu. Haushalte gehören zu einer Gruppe. Alle Personen in einem Haushalt teilen den Speiseplan und die Einkaufsliste. Das entspricht typischerweise den Anforderungen einer Familie. Die Rezeptsammlung ist umfassender: Haushalte teilen ihre Rezepte, Tags und Kategorien mit allen anderen Haushalten in derselben Gruppe. Separate Haushalte auf einem Server haben daher eigene Pläne und Listen, kochen aber aus denselben Rezepten. Das eignet sich auch für eine Wohngemeinschaft, in der sich niemand über Sardellen einig ist. Wenn Personen vollständig getrennte Sammlungen benötigen, weisen Sie ihnen separate Gruppen zu, weil zwischen Gruppen nichts geteilt wird.
Der Importer, der der Grund für den Betrieb dieser Anwendung ist
Öffnen Sie die Rezeptsammlung, wählen Sie die Erstellung eines Rezepts aus einer URL und fügen Sie einen Link ein. Mealie ruft die Seite ab und sucht nach strukturierten Rezeptdaten. Dabei handelt es sich um den maschinenlesbaren Block, den die meisten Rezeptseiten für Suchmaschinen einbetten. Ist dieser Block vorhanden, verläuft der Import sauber und sofort.
Wenn Sie einen AI-Anbieter konfigurieren, können Sie auch aus einem Bild oder aus eingefügtem Klartext importieren. Damit lässt sich beispielsweise ein Foto einer Seite aus einem Kochbuch verarbeiten. Für den Bildimport benötigen Sie einen Anbieter, der Bilder lesen kann. Ohne einen Anbieter stehen diese Importarten nicht zur Verfügung. Sie laufen über einen langsameren Pfad und sollten anschließend geprüft werden, da ein handschriftlicher Bruch leicht falsch gelesen wird.
Massenimporte starten auf demselben Bildschirm. Fügen Sie eine Liste von Adressen ein, eine pro Zeile, und Mealie verarbeitet sie im Hintergrund. Eine Sammlung mit zweihundert Lesezeichen lässt sich so in einem Durchgang übernehmen.
Mahlzeitenpläne und Einkaufsliste
Der Mahlzeitenplaner ist ein Kalender. Ziehen Sie ein Rezept auf einen Tag, um es einzuplanen. Fügen Sie die geplanten Rezepte einer Einkaufsliste hinzu, um ihre Zutaten zu erfassen. Um doppelte Einträge zusammenzufassen, legen Sie zunächst unter „Manage Data“ Foods und Units an. Aktivieren Sie anschließend bei jedem Rezept die Mengenangaben für Zutaten und ordnen Sie die Zutaten diesen Foods und Units zu. Dann ergeben zwei Rezepte mit Zwiebeln eine Zeile statt zwei.
Die Liste ist im Geschäft auf Ihrem Smartphone als aktuelle Seite verfügbar. Da sie auf Ihrem eigenen Server gespeichert ist, sehen alle Personen im Haushalt gleichzeitig dieselbe Liste. Wenn eine Person die Milch abhakt, wird sie auch vom Bildschirm der anderen Person entfernt.
Nginx und TLS davorschalten
Mealie verwendet in diesem Setup unverschlüsseltes HTTP. Es unterstützt TLS außerdem über TLS_CERTIFICATE_PATH und TLS_PRIVATE_KEY_PATH. Beenden Sie TLS in Nginx vor Mealie. Verweisen Sie zuerst mit einem DNS-A-Record auf Ihren Server, da der Zertifikatsschritt diesen Namen überprüft.
sudo apt update && sudo apt install -y nginx
sudo nano /etc/nginx/sites-available/mealieserver {
listen 80;
server_name recipes.example.com;
client_max_body_size 64M;
location / {
proxy_pass http://127.0.0.1:9925;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}sudo ln -s /etc/nginx/sites-available/mealie /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginxDie Ausgabe von nginx -t, syntax is ok und test is successful ist die Voraussetzung. Führen Sie den Reload erst aus, wenn dieser Test erfolgreich ist. Andernfalls bleibt bei einer fehlerhaften Konfiguration die alte Konfiguration aktiv, und der Fehler bleibt bis zum nächsten Neustart verborgen.
client_max_body_size 64M ist erforderlich, weil der Nginx-Standardwert 1 MB beträgt. Beim Hochladen eines Rezeptfotos oder beim Wiederherstellen eines Backups über den Browser wird ein größerer Request-Body übertragen. Ohne diese Zeile erhalten Sie von Nginx einen 413 Request Entity Too Large, nicht von Mealie. Deshalb erscheint im Anwendungslog überhaupt kein Eintrag.
Stellen Sie anschließend das Zertifikat aus. Dieser Schritt und der Timer für die Verlängerung werden unter ein Let's-Encrypt-Zertifikat für Nginx mit Certbot ausstellen beschrieben.
sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d recipes.example.comCertbot ändert den Serverblock so, dass er auf Port 443 lauscht, und fügt eine Weiterleitung von Port 80 hinzu. Rufen Sie die Website über https:// auf und prüfen Sie, ob der Browser das Zertifikat akzeptiert. Wenn Mealie geladen wird, die eigenen Links jedoch auf http:// verweisen, steht in BASE_URL noch http. Korrigieren Sie den Wert und führen Sie anschließend sudo docker compose up -d aus, um den Container mit dem neuen Wert neu zu erstellen.
Mealie kann nicht unter einem Unterpfad wie example.com/recipes bereitgestellt werden, da das Frontend nicht aus einem Unterpfad ausgeliefert werden kann. Verwenden Sie eine Subdomain.
Backups und die tatsächliche Wirkung einer Wiederherstellung
Alle von Mealie verwalteten Daten liegen im Container unter /app/data/. Dabei handelt es sich um das Volume mealie-data. Wenn Sie dieses Volume kopieren, kopieren Sie Rezepte, Bilder und Datenbank gemeinsam. Die Mealie-Dokumentation bezeichnet das Stoppen des Containers und Kopieren dieses Ordners als beste Methode für ein Backup einer SQLite-Installation.
sudo docker volume ls
sudo docker compose stop mealie
sudo docker run --rm -v mealie_mealie-data:/data -v "$PWD":/backup \
alpine tar czf /backup/mealie-data.tgz -C /data .
sudo docker compose start mealieDer Volume-Name trägt den Projektnamen als Präfix. Der Projektname entspricht dem Verzeichnis, in dem die Compose-Datei liegt. Für /srv/mealie lautet das Volume mealie_mealie-data. Deshalb verwendet der erste Befehl docker volume ls: Verwenden Sie den ausgegebenen Namen, nicht den Namen aus dieser Anleitung. Den Container zuerst zu stoppen ist wichtig, weil SQLite häufig gerade Schreibvorgänge ausführt. Eine laufende Kopie kann daher unlesbar wiederhergestellt werden.
Mealie verfügt außerdem über eine eigene Backup-Seite im Administrationsbereich. Diese schreibt ein ZIP-Archiv, in dem die Datenbank als database.json enthalten ist. Ein Archiv kann in einer Instanz mit derselben oder einer neueren Mealie-Version wiederhergestellt werden. Wenn Sie zwischen Servern umziehen, führen Sie auf dem neuen Server beim Übertragen des Volumes dieselbe festgelegte Version aus. Alternativ stellen Sie das Archiv in derselben oder einer neueren Version wieder her. Eine Wiederherstellung ist absichtlich destruktiv: Die aktuelle Datenbank wird vor dem Laden des Archivs gelöscht und dieser Vorgang kann nicht rückgängig gemacht werden. Nach Abschluss werden Sie abgemeldet.
Keine der beiden Kopien ist ein Backup, solange sie auf demselben Server liegt. Übertragen Sie das Archiv regelmäßig an einen anderen Speicherort. Dafür ist verschlüsseltes Off-Server-Backup mit restic vorgesehen.
Mealie aktualisieren
cd /srv/mealie
sudo nano docker-compose.yml
sudo docker compose pull
sudo docker compose up -d
sudo docker compose logs -f mealieErhöhen Sie die festgelegte Version in der Datei. Laden Sie anschließend das Image herunter und erstellen Sie den Container neu. Migrationen werden beim ersten Start des neuen Images ausgeführt. Erstellen Sie vor einem Wechsel der Hauptversion eine Kopie des Volumes. Wenn eine Migration auf halber Strecke fehlschlägt, bleibt eine Datenbank zurück, die das vorherige Image nicht mehr öffnen kann. Lesen Sie die Release Notes für alle Versionen zwischen Ihrer aktuellen und der neuen Version.
Wenn der Importer fehlschlägt
Einige Websites veröffentlichen überhaupt keine strukturierten Rezeptdaten. Mealie importiert dann einen Titel mit einer leeren Zutatenliste. Ohne einen AI-Provider lässt sich das nicht durch eine Konfiguration beheben. Fügen Sie den Rezepttext stattdessen manuell ein. Wenn ein Provider konfiguriert ist, übergibt Mealie den Seiteninhalt an das Modell, wenn der Scraper nichts findet. Das Ergebnis muss wie jeder andere AI-Import mit dem Original abgeglichen werden.
Andere Fehler werden durch den Bot-Schutz vor der Rezept-Website verursacht. Dieser antwortet Mealie mit einer Challenge-Seite statt mit dem Rezept. Mealie gibt sich bereits als Browser aus und wechselt seinen User-Agent, um dies zu reduzieren. Wenn eine Website weiterhin ablehnt, können Sie den Scraper nach der dokumentierten Vorgehensweise über einen Proxy mit besserem Ruf der Adresse leiten oder eine FlareSolverr-Instanz ausführen, die die Challenge in einem echten Browser löst. Beide Optionen sind freiwillig und werden über Umgebungsvariablen am Container konfiguriert.
Ein Import, der fehlschlägt, weil Ihr Server die Website überhaupt nicht erreichen kann, ist ein anderes Problem. Testen Sie dies direkt auf dem Server mit curl -I https://the-site.example/recipe und lesen Sie die Statuszeile, bevor Sie den Scraper verdächtigen. Seit v3.26.0 verweigert Mealie außerdem den Abruf von privaten oder internen Adressen. Eine Rezeptseite in Ihrem eigenen Netzwerk wird daher erst importiert, wenn Sie ihren Host in die Umgebungsvariable HTTP_ALLOW_LIST aufnehmen.
Wo es hineinpasst
Mealie ist eine gute erste Self-Hosted-Anwendung für einen Haushalt, weil die Personen, mit denen Sie zusammenleben, sie ohne Aufforderung verwenden werden. Die Aufgabe entspricht im Wesentlichen dem Betrieb Ihrer eigenen Fotobibliothek mit Immich, ist jedoch deutlich ressourcenschonender. Außerdem gehört sie zur größeren Liste der Anwendungen, deren Self-Hosting sich in diesem Jahr lohnt. Ein kleiner Server kann beides betreiben. Immich ist nicht die einzige Option für diese zweite Aufgabe. Wenn Sie noch entscheiden, sind die Mindestanforderungen an den Arbeitsspeicher und die Backup-Befehle von PhotoPrism und Immich unterschiedlich genug, um sie zu lesen, bevor Sie den restlichen Speicherplatz verplanen. Wenn der Haushalt neben den Mahlzeiten auch seine Pläne und Notizen verwaltet, ist ein selbst gehosteter AFFiNE-Arbeitsbereich wieder dieselbe Übung mit einer Compose-Datei. Er benötigt jedoch vier Container und deutlich mehr Arbeitsspeicher als Mealie. Prüfen Sie daher zuerst, welche Ressourcen auf dem Server noch verfügbar sind. Wenn der Haushalt neben den Mahlzeiten auch seine Trainingseinheiten erfassen möchte, verwaltet openGym die Workouts und verwendet denselben festgelegten Tag, dieselbe Compose-Datei und dasselbe Zertifikat, die Sie gerade eingerichtet haben. Der Abend nach dem Essen hat ebenfalls eine eigene Variante: Halcyon baut eine vorhandene Jellyfin-Bibliothek zu einer Videothek aus den 1990er-Jahren um, durch die Sie sich bewegen können. Dabei handelt es sich um einen weiteren kleinen Container vor etwas, das Sie bereits betreiben, und nicht um eine weitere Datenbank, die gesichert werden muss. Nicht alles in dieser Gruppe ist eine Haushaltsanwendung. Wenn dieselbe Gewohnheit irgendwann auch berufliche Aufgaben unterstützen soll, ist ein selbst gehosteter Chatwoot-Supportdesk wieder mit demselben festgelegten Tag und Zertifikat eingerichtet, dahinter jedoch mit Postgres, Redis und funktionierendem ausgehendem E-Mail-Versand. Das ist ein deutlich ressourcenintensiverer Mandant als eine Rezeptverwaltung und sollte auf einem eigenen Server betrieben werden.
FAQ
Warum schlägt der Import einer Rezept-URL fehl?
Dafür gibt es zwei häufige Ursachen. Entweder veröffentlicht die Seite keine strukturierten Rezeptdaten. Dann findet der Scraper nichts und liefert, sofern kein AI-Provider für das Einlesen der Seite konfiguriert ist, einen Titel ohne Zutaten. Oder eine Bot-Schutzschicht vor der Website liefert statt des Rezepts eine Challenge-Seite zurück. Im zweiten Fall kann Mealie auf einen Proxy mit besserer Adressreputation oder auf eine selbst gehostete FlareSolverr-Instanz verwiesen werden, die die Challenge in einem echten Browser löst. Prüfen Sie mit curl -I, ob Ihr Server die Seite überhaupt erreichen kann, bevor Sie etwas ändern.
Benötige ich PostgreSQL, oder reicht SQLite aus?
Für einen Haushalt reicht SQLite aus. Es ist außerdem die Standardeinstellung. Wechseln Sie zu PostgreSQL, wenn das Datenverzeichnis auf netzwerkgebundenem Speicher liegt, weil SQLite über ein Netzwerkdateisystem Fehler wegen gesperrter Datenbanken erzeugt und die Datei beschädigen kann. Für Wiederherstellungen unter PostgreSQL muss der Datenbankbenutzer ein Superuser sein, da die Wiederherstellung vor dem Laden des Archivs alle Daten löscht.
Kann ich Mealie ohne Domainnamen betreiben?
Ja, in Ihrem eigenen Netzwerk. Setzen Sie BASE_URL auf die Adresse, die Sie tatsächlich eingeben werden, zum Beispiel http://192.168.1.20:9925, ändern Sie das Port-Mapping mit der LAN-Adresse Ihres Servers auf 192.168.1.20:9925:9000 und lassen Sie nginx weg. Führen Sie sudo docker compose up -d aus, um beide Änderungen anzuwenden. Das ursprüngliche 127.0.0.1:9925:9000-Mapping akzeptiert nur Verbindungen vom Docker-Host. Einladungs- und Links zum Zurücksetzen des Passworts werden aus BASE_URL erzeugt. Ein falscher Wert führt daher zu Links, die niemand sonst öffnen kann. Machen Sie den Dienst nicht über unverschlüsseltes HTTP im Internet erreichbar, weil die Anmeldung dann im Klartext übertragen wird.
Wie gebe ich meiner Familie eigene Anmeldungen?
Lassen Sie ALLOW_SIGNUP auf "false" gesetzt und fügen Sie Personen im Administrationsbereich hinzu. Dadurch wird ein Einladungslink erzeugt, den Sie an sie senden. Ordnen Sie alle Personen, die sich eine Küche teilen, demselben Haushalt zu, damit sie den Speiseplan und die Einkaufsliste gemeinsam nutzen. Rezepte werden unabhängig davon mit jedem Haushalt in der Gruppe geteilt. Personen, die getrennte Sammlungen benötigen, brauchen daher getrennte Gruppen.
Was passiert mit meinen Rezepten, wenn ich Mealie nicht mehr betreibe?
Sie können exportiert werden. Das Administrations-Backup schreibt Ihre Daten als JSON. Mealie kann Rezepte außerdem als JSON-Dateien exportieren, die sich ohne zusätzliche Software in jedem Texteditor lesen lassen. Erstellen Sie einen Export, bevor Sie ihn benötigen, und prüfen Sie, ob Sie ihn öffnen können.