SSD Nodes Learn Hosting plans →
Gidsen Matt ConnorDoor Matt Connor

Mealie installeren op een VPS met Docker Compose

Installeer Mealie zelf op een VPS met Docker Compose. Beheer recepten zonder advertenties, maak maaltijdplannen en genereer boodschappenlijsten. Inclusief Nginx en TLS.

Wat een zelfgehoste receptenbeheerder doet

Een zelfgehoste receptenbeheerder slaat uw recepten op in een database op een server die u zelf beheert, en Mealie is de keuze waar de meeste huishoudens op uitkomen. U plakt het adres van een receptenpagina en Mealie leest de ingrediënten, de stappen, de opbrengst en de bereidingstijd eruit, terwijl het de verhalen en advertenties weglaat. Wat in uw verzameling terechtkomt, is het eten zelf.

De rest van de applicatie is compact. Er is een wekelijkse maaltijdplanner waar u recepten naartoe sleept, en een boodschappenlijst die op basis van dat plan wordt samengesteld. Elke persoon die kookt krijgt een eigen inlogaccount. Alles draait in één container en verbruikt nauwelijks resources tussen verzoeken door, waardoor een bescheiden VPS de applicatie moeiteloos draait.

Deze handleiding maakt gebruik van Docker Compose. Als de termen services: en volumes: nieuw voor u zijn, lees dan eerst hoe Docker Compose-bestanden zijn opgebouwd, aangezien alles hieronder één compose-bestand en vier commando's beslaat.

Mealie installeren met Docker Compose

Mealie publiceert zijn images naar de GitHub container registry. Sinds 18 november 2026 is de huidige stabiele tag v3.31.0, uitgebracht op 13 november. Deze release bevat beveiligingsfixes en het project raadt iedereen aan om te updaten. Pin een versie in plaats van latest te gebruiken: met latest kan een docker compose pull op een willekeurige dag u dwingen tot een databasemigratie waar u nog niet klaar voor bent.

sudo mkdir -p /srv/mealie
cd /srv/mealie
sudo nano docker-compose.yml
services:
  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:

Twee regels verdienen aandacht voordat u het start.

De poort is geschreven als 127.0.0.1:9925:9000 en niet als 9925:9000. De container luistert intern op 9000 en de host mapt 9925 hiernaartoe. Door die mapping te binden aan het loopback-adres kan nginx Mealie bereiken, maar het internet niet. Docker schrijft zijn eigen regels in de packet filter, dus een standaard 9925:9000 is bereikbaar vanaf buiten, zelfs als uw firewall zegt dat de poort gesloten is. Het is nuttig om die verrassing één keer te begrijpen: zie waarom gepubliceerde Docker-poorten ufw negeren.

BASE_URL moet het exacte publieke adres zijn dat u gaat gebruiken, met het schema en zonder afsluitende slash. Mealie bouwt wachtwoordherstel- en uitnodigingslinks op basis hiervan. Stel dit in op http://localhost:9925 en de uitnodiging die u naar uw partner stuurt, bevat een link die alleen op de server zelf werkt.

Start het en bekijk de eerste boot.

sudo docker compose up -d
sudo docker compose logs -f mealie

De eerste start maakt de SQLite-database aan en voert de migraties uit, wat enkele seconden duurt. Wanneer het logbestand stabiliseert en stopt met het tonen van migratieregels, controleer de app dan lokaal.

curl -I http://127.0.0.1:9925

Een 200 OK betekent dat de app draait. Als u Connection refused krijgt, voer dan sudo docker compose ps -a uit om de status en exitcode van de container te controleren. Een container die stopte met code 137 ontving SIGKILL; die code alleen laat niet zien dat de geheugenlimiet van 1000M werd overschreden. Het handmatig doden van de container produceert ook die code.

Eerste aanmelding en het uitschakelen van open registratie

Het standaardaccount is changeme@example.com met het wachtwoord MyPassword. Meld u hiermee aan en wijzig beide direct, aangezien deze combinatie in de documentatie staat en daarom door elke scanner wordt gevonden.

ALLOW_SIGNUP: "false" in het compose-bestand is een bewuste keuze. Als registratie openstaat, kan iedereen die het adres vindt een account aanmaken in uw receptenbox. Als deze is gesloten, voegt u mensen toe vanuit het beheerderspaneel. Dit genereert een uitnodigingslink die u zelf verstuurt. Die link wordt opgebouwd op basis van BASE_URL, en daarom is de waarde ervan van belang. Als u uiteindelijk meerdere applicaties op dezelfde server draait en voor alle applicaties hetzelfde wachtwoord wilt gebruiken, kan Mealie de aanmelding uitbesteden aan een externe identiteitsprovider, zoals een zelfgehoste Authentik-instantie.

Mealie plaatst gebruikers in een huishouden, en huishoudens bevinden zich binnen een groep. Iedereen in een huishouden deelt de maaltijdplanning en de boodschappenlijst; dit is wat een gezin doorgaans wenst. De receptenverzameling is breder: huishoudens delen hun recepten, tags en categorieën met elk ander huishouden in dezelfde groep. Afzonderlijke huishoudens op één server behouden dus hun eigen planningen en lijsten, maar koken vanuit dezelfde recepten. Dit is nog steeds geschikt voor een woongroep waar men het niet eens kan worden over ansjovis. Als mensen volledig gescheiden verzamelingen nodig hebben, wijst u ze toe aan aparte groepen, aangezien er tussen groepen niets wordt gedeeld.

De importfunctie, de reden om dit te draaien

Open de receptencollectie, kies voor het aanmaken van een recept vanaf een URL en plak een link. Mealie haalt de pagina op en zoekt naar gestructureerde receptgegevens; dit is het machineleesbare blok dat de meeste receptensites insluiten voor zoekmachines. Wanneer dit blok aanwezig is, verloopt de import direct en foutloos.

Als u een AI-provider configureert, kunt u ook importeren vanaf een afbeelding of vanuit platte tekst die u plakt; dit is handig voor een foto van een pagina uit een kookboek. Voor het importeren van afbeeldingen is een provider vereist die afbeeldingen kan lezen. Zonder provider zijn deze importopties niet beschikbaar. Deze verlopen via een trager proces en vereisen achteraf controle, aangezien een handgeschreven breuk gemakkelijk verkeerd kan worden gelezen.

Bulk-imports worden vanuit hetzelfde scherm uitgevoerd: plak een lijst met adressen, één per regel, en Mealie verwerkt deze op de achtergrond. Een verzameling van tweehonderd bladwijzers wordt zo in één sessie overgezet.

Maaltijdplanning en de boodschappenlijst

De maaltijdplanner is een kalender. Sleep een recept naar een dag om het in te plannen. Voeg de geplande recepten toe aan een boodschappenlijst om de ingrediënten te verzamelen. Om dubbele items samen te voegen, moet u eerst Foods en Units invoeren onder Manage Data. Schakel vervolgens de ingrediënthoeveelheden in bij elk recept en parseer de ingrediënten naar deze Foods en Units. Hierdoor resulteren twee recepten die uien vereisen in één regel in plaats van twee.

De lijst is een live pagina die u in de winkel op uw telefoon kunt bekijken. Omdat de lijst op uw eigen server staat, ziet iedereen in het huishouden dezelfde lijst op hetzelfde moment. Wanneer één persoon melk afvinkt, verdwijnt dit item direct van het scherm van de andere persoon.

Plaats nginx en TLS voor de applicatie

Mealie gebruikt in deze opstelling standaard HTTP; het ondersteunt ook TLS via TLS_CERTIFICATE_PATH en TLS_PRIVATE_KEY_PATH. Beëindig de transportlaagbeveiliging (TLS) in nginx vóór de applicatie. Wijs eerst een DNS A-record naar uw server, aangezien de certificaatstap deze naam verifieert.

sudo apt update && sudo apt install -y nginx
sudo nano /etc/nginx/sites-available/mealie
server {
    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 nginx

nginx -t uitvoeren met syntax is ok en test is successful is de controle. Herlaad pas nadat de controle slaagt, omdat het herladen van een defecte configuratie de oude configuratie actief laat en de fout verbergt tot de volgende herstart.

client_max_body_size 64M is aanwezig omdat de standaardwaarde van nginx 1 MB is. Het uploaden van een receptfoto of het herstellen van een back-up via de browser verstuurt een grotere body dan dat. Zonder deze regel ontvangt u een 413 Request Entity Too Large van nginx, niet van Mealie, waardoor het applicatielogboek niets weergeeft.

Vraag vervolgens het certificaat aan. Die stap en de bijbehorende vernieuwingstimer worden behandeld in een Let's Encrypt-certificaat voor nginx uitgeven met certbot.

sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d recipes.example.com

Certbot herschrijft het serverblok om te luisteren op 443 en voegt een redirect toe vanaf poort 80. Laad de site via https:// en bevestig dat de browser het certificaat accepteert. Als Mealie laadt, maar de interne links u doorsturen naar http://, dan bevat BASE_URL nog steeds http en moet dit worden gecorrigeerd, gevolgd door sudo docker compose up -d om de container opnieuw aan te maken met de nieuwe waarde.

Het aanbieden van Mealie onder een subpad zoals example.com/recipes werkt niet, omdat de frontend niet vanaf een subpad kan worden geserveerd. Gebruik een subdomein.

Back-ups, en wat een restore werkelijk doet

Alles wat Mealie bezit, bevindt zich in /app/data/ in de container, wat het mealie-data volume is. Kopieer dat volume en u heeft de recepten, de afbeeldingen en de database samen gekopieerd. De eigen documentatie van Mealie noemt het stoppen van de container en het kopiëren van deze map de beste manier om een SQLite-installatie te back-uppen.

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 mealie

De volumenaam draagt de projectnaam als voorvoegsel, en de projectnaam is de map die het compose-bestand bevat. Vanaf /srv/mealie is het volume mealie_mealie-data, daarom is het eerste commando docker volume ls: gebruik de naam die het afdrukt, niet de naam in deze handleiding. Het stoppen van de container is belangrijk, omdat SQLite vaak midden in een schrijfactie zit, waardoor een live kopie onleesbaar kan zijn bij herstel.

Mealie heeft ook een eigen back-uppagina in het beheerdersgedeelte, die een zip-archief schrijft met de database als database.json. Een archief kan worden teruggezet in een instantie die dezelfde of een nieuwere versie van Mealie draait. Om tussen servers te verhuizen, draait u dezelfde gepinde versie op de nieuwe machine bij het kopiëren van het volume, of herstelt u het archief in dezelfde of een nieuwere versie. Het herstellen van een back-up is destructief van ontwerp: het verwijdert de huidige database voordat het archief wordt geladen en dit kan niet ongedaan worden gemaakt. U wordt uitgelogd wanneer het proces is voltooid.

Geen van beide kopieën is een back-up zolang deze op dezelfde server staat. Verplaats het archief volgens een schema naar een andere locatie, waarvoor versleutelde off-server back-ups met restic bedoeld is.

Mealie bijwerken

cd /srv/mealie
sudo nano docker-compose.yml
sudo docker compose pull
sudo docker compose up -d
sudo docker compose logs -f mealie

Verhoog de vastgezette versie in het bestand, haal vervolgens de nieuwe image op en maak de container opnieuw aan. Migraties worden uitgevoerd bij de eerste start van de nieuwe image. Maak een kopie van het volume voordat u een grote versie-update doorvoert, omdat een mislukte migratie een database achterlaat die de vorige image niet meer kan openen. Lees de release notes voor alle versies tussen uw huidige versie en de nieuwe versie.

Wanneer de importeur faalt

Sommige websites publiceren helemaal geen gestructureerde receptgegevens, waardoor Mealie een titel importeert met een lege ingrediëntenlijst. Zonder AI-provider is dit niet via configuratie op te lossen; plak de recepttekst in dat geval handmatig. Met een geconfigureerde provider stuurt Mealie de pagina-inhoud naar het model wanneer de scraper niets vindt. Het resultaat vereist, net als bij elke andere AI-import, een controle tegen het origineel.

Andere fouten ontstaan door bot-beveiliging op de receptenwebsite, die Mealie beantwoordt met een uitdagingspagina in plaats van het recept. Mealie imiteert al een browser en roteert zijn user agent om dit te beperken. Wanneer een site blijft weigeren, zijn de gedocumenteerde opties om de scraper via een proxy met een betere adresreputatie te sturen, of een FlareSolverr-instantie te draaien die de uitdaging in een echte browser oplost. Beide zijn optioneel en worden via omgevingsvariabelen op de container ingesteld.

Een import die faalt omdat uw server de site helemaal niet kan bereiken, is een ander probleem. Test dit vanaf de server met curl -I https://the-site.example/recipe en lees de statusregel voordat u de scraper de schuld geeft. Sinds v3.26.0 weigert Mealie ook om gegevens op te halen van private of interne adressen; een receptpagina op uw eigen netwerk zal dus niet importeren totdat u de host toevoegt aan de HTTP_ALLOW_LIST omgevingsvariabele.

Waar het past

Mealie is een goede eerste zelfgehoste applicatie voor een huishouden, omdat de mensen met wie u samenwoont het zullen gebruiken zonder dat u erom hoeft te vragen. Het is een vergelijkbare taak als het draaien van uw eigen fotobibliotheek met Immich, hoewel het veel lichter is, en het past in de bredere lijst van dingen die het waard zijn om dit jaar zelf te hosten. Eén kleine server kan beide aan. Immich is niet de enige kandidaat voor die tweede taak, en als u nog aan het beslissen bent, verschillen de geheugenvereisten en back-upcommando's van PhotoPrism en Immich genoeg om te lezen voordat u de rest van de schijf in gebruik neemt. Als het huishouden naast de maaltijden ook zijn plannen en notities ergens bijhoudt, is een zelfgehoste AFFiNE-werkruimte opnieuw dezelfde oefening met een compose-bestand, maar deze vereist vier containers en aanzienlijk meer geheugen dan Mealie, dus controleer eerst wat de server nog beschikbaar heeft. En als het huishouden naast de maaltijden ook de trainingen wil bijhouden, houdt openGym de workouts bij en vraagt om dezelfde vastgezette tag, hetzelfde compose-bestand en hetzelfde certificaat waar u zojuist mee heeft gewerkt. De avond na het eten heeft zijn eigen versie hiervan, aangezien Halcyon een bestaande Jellyfin-bibliotheek herbouwt als een videotheek uit de jaren 90 waar u doorheen kunt lopen, wat weer een kleine container is die voor iets draait dat u al heeft, in plaats van nog een database om te back-uppen. Niet alles in deze familie is een huishoudelijke app, en als dezelfde gewoonte ooit iets voor werk moet dragen, is een zelfgehoste Chatwoot-supportdesk opnieuw dezelfde vastgezette tag en hetzelfde certificaat met Postgres, Redis en werkende uitgaande e-mail erachter, wat een veel zwaardere tenant is dan een receptendoos en een eigen server verdient.

FAQ

Waarom mislukt het importeren van een recept-URL?

Er zijn twee veelvoorkomende oorzaken. Of de pagina publiceert geen gestructureerde receptgegevens, waardoor de scraper niets vindt en u, tenzij er een AI-provider is geconfigureerd om de pagina te lezen, een titel zonder ingrediënten krijgt; of een bot-beveiligingslaag voor de site retourneert een uitdagingspagina in plaats van het recept. In het tweede geval kan Mealie worden gekoppeld aan een proxy met een betere adresreputatie, of aan een zelfgehoste FlareSolverr-instantie die de uitdaging in een echte browser oplost. Bevestig dat uw server de pagina überhaupt kan bereiken met curl -I voordat u iets wijzigt.

Heb ik PostgreSQL nodig, of is SQLite voldoende?

SQLite is voldoende voor een huishouden en is de standaard. Stap over op PostgreSQL wanneer de datamap op network attached storage staat, omdat SQLite via een netwerkbestandssysteem fouten met een vergrendelde database veroorzaakt en het bestand kan beschadigen. Voor restores onder PostgreSQL moet de databasegebruiker een superuser zijn, aangezien de restore alles verwijdert voordat het archief wordt geladen.

Kan ik Mealie draaien zonder domeinnaam?

Ja, op uw eigen netwerk. Stel BASE_URL in op het adres dat u daadwerkelijk zult typen, zoals http://192.168.1.20:9925, wijzig de poortmapping naar 192.168.1.20:9925:9000 met het LAN-adres van uw server en sla nginx over. Voer sudo docker compose up -d uit om beide wijzigingen toe te passen. De oorspronkelijke 127.0.0.1:9925:9000-mapping accepteert alleen verbindingen vanaf de Docker-host. Uitnodigings- en wachtwoordherstellinks worden opgebouwd vanuit BASE_URL, dus een onjuiste waarde produceert links die niemand anders kan openen. Stel het niet bloot aan het internet via onversleuteld HTTP, omdat de inloggegevens dan in leesbare tekst worden verzonden.

Hoe geef ik mijn familie hun eigen inloggegevens?

Laat ALLOW_SIGNUP ingesteld op "false" en voeg mensen toe vanuit het beheerdersgedeelte, wat een uitnodigingslink genereert die u naar hen verstuurt. Plaats iedereen die een keuken deelt in hetzelfde huishouden, zodat zij het maaltijdplan en de boodschappenlijst delen. Recepten worden hoe dan ook gedeeld met elk huishouden in de groep, dus mensen die aparte collecties nodig hebben, hebben aparte groepen nodig.

Wat gebeurt er met mijn recepten als ik stop met het draaien van Mealie?

Ze komen eruit. De beheerdersback-up schrijft uw gegevens als JSON, en Mealie kan recepten ook exporteren als JSON-bestanden, die in elke teksteditor leesbaar blijven zonder enige software. Maak één export voordat u deze nodig heeft en controleer of u deze kunt openen.

Was dit artikel nuttig?