Mealie : votre livre de recettes, planificateur de menus et liste de courses sur un VPS

Une recette reste dans les favoris, une autre dans une conversation, une troisième sur une capture d’écran, tandis qu’il faut retrouver la quatrième sur un site au milieu des publicités et d’une longue introduction. Mealie rassemble tout au même endroit : vous collez un lien et obtenez une fiche avec les ingrédients, les instructions et une photo. Vous pouvez ensuite ajouter le plat au calendrier et transférer les produits vers une liste de courses commune.

Nous allons voir ce que Mealie sait faire, à qui il peut être utile, quel serveur est nécessaire et comment lancer votre propre gestionnaire de recettes sur un VPS avec Docker Compose.

Qu’est-ce que Mealie ?

Mealie est une application auto-hébergée gratuite destinée au stockage des recettes, à la planification des repas et à la gestion des listes de courses. Le service fonctionne sur votre propre serveur : vous décidez donc où la base de données est stockée, qui peut y accéder et comment les sauvegardes sont créées.

L’interface s’ouvre dans un navigateur depuis un ordinateur ou un téléphone. Les recettes peuvent être créées manuellement, importées depuis des sites, regroupées dans des catégories et des livres de cuisine, ajoutées à un menu hebdomadaire et partagées en famille.

La principale différence entre Mealie et un dossier de notes réside dans les liens entre les éléments. Une recette peut être ajoutée à un programme de repas, reliée à une liste de courses, filtrée par étiquettes et utilisée dans des automatisations via l’API.

Les principales fonctionnalités de Mealie

Importer une recette à partir d’un seul lien

L’utilisateur colle une URL et Mealie tente d’extraire le nom du plat, le nombre de portions, les ingrédients, les étapes et l’image. Au lieu d’un favori supplémentaire, vous obtenez une fiche propre que vous pouvez modifier et enregistrer.

Cette fonction est particulièrement utile sur les sites où la recette est entourée de publicités et de texte superflu. Si une page utilise un balisage inhabituel, certaines données doivent parfois être corrigées manuellement.

Mealie peut également transférer des collections depuis Paprika, Tandoor, Nextcloud Cookbooks et plusieurs autres gestionnaires de recettes. Il n’est donc pas nécessaire de commencer avec une bibliothèque vide.

Importer depuis une photo, un texte ou une vidéo

Une intégration d’IA facultative peut reconstituer une recette à partir d’un texte, d’une photo d’une page de livre de cuisine ou d’un lien vidéo. Pour une vidéo, le service récupère une transcription, puis en extrait les ingrédients et l’ordre des étapes.

Cette fonction nécessite un fournisseur d’IA compatible. Vous pouvez connecter une API externe ou votre propre service compatible avec OpenAI, par exemple Ollama. Avant de l’activer, il convient de prendre en compte le coût des requêtes et la politique de traitement des données du fournisseur choisi.

Planificateur de menus et liste de courses

Les plats sont organisés par jour et par type de repas. Vous pouvez ajouter une recette, une note comme « restes d’hier » ou un plat aléatoire selon une règle, par exemple ne sélectionner que des dîners rapides le vendredi.

Les ingrédients des recettes sont transférés dans la liste de courses. Les articles peuvent être cochés depuis un téléphone et classés par rayon du magasin. Mealie ne sert donc pas seulement d’archive : il devient un outil pratique pour toute la semaine.

Accès familial et automatisations

Mealie prend en charge les utilisateurs, les groupes et les foyers. Une famille peut utiliser une collection de recettes commune tout en conservant, lorsque cela est nécessaire, des programmes de repas et des listes de courses séparés.

L’API REST, les notifications et les webhooks permettent de relier le service à d’autres systèmes. L’intégration officielle avec Home Assistant affiche par exemple les prochains repas dans le calendrier et fonctionne avec la liste de courses.

À qui Mealie convient-il ?

Mealie est utile lorsque les recettes sont dispersées entre des sites, des notes et des photos ; lorsqu’il faut recréer le menu à chaque fois ; lorsque plusieurs personnes utilisent le même panier de courses ; lorsque le contrôle de sa propre base est important ; ou lorsque des automatisations sont nécessaires.

Le service peut être excessif si vous ne cuisinez que quelques plats habituels et ne souhaitez pas administrer Docker. L’auto-hébergement supprime la dépendance à un compte cloud tiers, mais le serveur doit malgré tout être mis à jour, sécurisé et sauvegardé.

Quel serveur faut-il pour Mealie ?

Dans la configuration Docker Compose officielle, le conteneur est limité à 1 000 Mo de mémoire. Une petite installation peut fonctionner avec 1 vCPU et 1 Go de RAM, mais un VPS doté de 2 Go offre une marge pour Linux, Docker, un proxy inverse et les mises à jour. L’espace disque est principalement utilisé par les photos et les sauvegardes.

Scénario	CPU	RAM	Disque
Base personnelle avec SQLite	1 vCPU	1 Go	SSD de 10 à 20 Go
Famille, HTTPS et autres conteneurs	1–2 vCPU	2 Go	SSD de 20 Go ou plus
PostgreSQL ou nombreux utilisateurs	2 vCPU	2–4 Go	SSD de 20 Go ou plus

Il s’agit de valeurs de départ pratiques, et non d’un minimum officiel strict. Si l’IA fonctionne via une API externe, les calculs ne sont pas effectués sur le VPS. Les ressources nécessaires à un modèle local doivent être évaluées séparément.

SQLite ou PostgreSQL

SQLite est plus simple et la documentation de Mealie le recommande pour 1 à 20 utilisateurs avec peu d’opérations simultanées. Pour une installation personnelle ou familiale, c’est généralement le meilleur point de départ.

PostgreSQL est préférable en cas de forte charge simultanée, lorsque la recherche approximative est nécessaire ou lorsque les données sont placées sur un stockage réseau. L’utilisation de SQLite sur un NAS est déconseillée, car elle peut provoquer des verrouillages de la base et une corruption des données.

Installer Mealie sur un VPS avec Docker Compose

L’exemple ci-dessous utilise SQLite. Docker Engine et Docker Compose doivent déjà être installés sur le serveur. Un système Ubuntu ou Debian 64 bits sur amd64 ou arm64 convient.

1. Créez un répertoire

sudo mkdir -p /opt/mealie
cd /opt/mealie
sudo nano docker-compose.yml

2. Ajoutez la configuration

services:
  mealie:
    image: ghcr.io/mealie-recipes/mealie:v3.24.0
    container_name: mealie
    restart: unless-stopped
    ports:
      - "9925:9000"
    deploy:
      resources:
        limits:
          memory: 1000M
    volumes:
      - mealie-data:/app/data/
    environment:
      ALLOW_SIGNUP: "false"
      PUID: "1000"
      PGID: "1000"
      TZ: "Etc/UTC"
      BASE_URL: "https://recipes.example.com"

volumes:
  mealie-data:

Remplacez TZ et BASE_URL par vos propres valeurs. Au 29 août 2026, la version actuelle est v3.24.0. Avant l’installation, vérifiez la version la plus récente et utilisez une balise précise plutôt que latest afin d’éviter une mise à jour inattendue.

3. Lancez Mealie

sudo docker compose up -d
sudo docker compose ps

Ouvrez http://IP_DU_SERVEUR:9925. L’identifiant par défaut est [email protected] et le mot de passe est MyPassword. Modifiez immédiatement les identifiants de l’administrateur.

4. Activez HTTPS

Pour un accès permanent, associez un domaine, placez Nginx, Caddy ou Traefik devant Mealie et générez un certificat TLS. Limitez ensuite le port à localhost :

ports:
  - "127.0.0.1:9925:9000"

Si le service n’est nécessaire qu’à domicile, vous pouvez ne pas le publier sur Internet et y accéder via un VPN.

Que configurer après le lancement ?

Changez le mot de passe, vérifiez que l’inscription libre est désactivée et créez les comptes des membres de la famille. Ajoutez ensuite quelques étiquettes simples, par exemple « rapide », « à congeler » et « dîner ». Une structure trop complexe ne ferait que gêner au début.

Importez plusieurs recettes réelles, vérifiez les portions et les unités de mesure, ajoutez des plats au planificateur et créez votre première liste de courses. Le fonctionnement principal de Mealie devient ainsi clair en une soirée.

Sécurité et sauvegardes

Une installation publique nécessite un mot de passe robuste, HTTPS, des inscriptions fermées et des mises à jour régulières. La documentation met particulièrement en garde contre les méthodes d’API qui importent des URL : sans limitation de la fréquence des requêtes, elles peuvent générer une charge inutile. Il est préférable de configurer une limitation de débit sur le proxy inverse.

Comme l’importation oblige le conteneur à se connecter à des adresses externes, Mealie doit être isolé des services internes sur un réseau domestique sensible.

Le panneau d’administration permet de créer, télécharger et restaurer une sauvegarde complète. Cependant, Mealie n’effectue plus de sauvegardes automatiques planifiées. Avec SQLite, il est également plus sûr de copier l’intégralité du volume /app/data vers un stockage externe. Une sauvegarde conservée sur le même VPS ne protège pas contre la perte du serveur.

Les limites de Mealie

L’importation dépend du balisage du site, certaines fiches doivent donc être corrigées manuellement. La mise à l’échelle des ingrédients peut également produire des erreurs si la recette d’origine utilise du texte libre au lieu d’unités standard.

Le client principal est l’interface web. Elle est pratique dans un navigateur mobile, mais les applications natives sont développées séparément. Le propriétaire reste en outre responsable de Docker, de HTTPS, des mises à jour et des sauvegardes.

Mealie est particulièrement efficace sous la forme d’un processus continu : enregistrer une recette trouvée, la planifier pour un jour donné et ne pas oublier les ingrédients.

Mealie sur un VPS de tropic.host

Un serveur domestique convient s’il fonctionne en permanence et si l’accès à distance est déjà configuré. Un VPS est plus pratique lorsque les recettes et la liste de courses doivent être accessibles de partout, sans redirection de ports sur le routeur domestique.

Pour une installation familiale, vous pouvez utiliser un VPS Linux de tropic.host avec 2 Go de RAM. Cela suffit pour Mealie, Docker et un proxy inverse avec une marge raisonnable. Vous pouvez commencer avec SQLite, puis augmenter les ressources ou passer à PostgreSQL lorsque la charge progresse.

Un VPS ne remplace pas les sauvegardes : la base de données et les photos des recettes doivent être exportées séparément et régulièrement.

Conclusion rapide

Mealie conserve les recettes sous une forme claire, aide à planifier les menus et rassemble les ingrédients dans une liste de courses commune. Sa fonction la plus convaincante est l’importation par lien, tandis que l’accès familial, le planificateur et les intégrations transforment la bibliothèque en outil du quotidien.

Pour un usage personnel ou familial, un petit VPS, Docker et SQLite suffisent. En contrepartie, il faut surveiller les mises à jour, HTTPS et les sauvegardes.

FAQ

Mealie est-il gratuit ?

Oui. Le projet est distribué sous licence AGPL-3.0. Des frais peuvent toutefois s’appliquer au VPS, au domaine et aux requêtes d’IA externes.

Peut-on importer des recettes depuis des sites en russe ?

Oui, si la page contient un balisage de recette compréhensible. La qualité dépend du site ; les erreurs peuvent être corrigées manuellement ou à l’aide de l’importation par IA.

De combien de RAM Mealie a-t-il besoin ?

Pour une petite installation avec SQLite, vous pouvez commencer avec 1 Go. Pour un VPS exécutant Linux, un proxy inverse et d’autres conteneurs, 2 Go sont plus pratiques.

Un domaine est-il nécessaire ?

Non. Une adresse IP suffit sur un réseau local ou via un VPN. Pour un accès sécurisé depuis Internet, un domaine et HTTPS sont plus pratiques.

Que choisir : SQLite ou PostgreSQL ?

SQLite est plus simple et convient à la plupart des installations de 1 à 20 utilisateurs. PostgreSQL est préférable en cas de forte charge simultanée, de stockage sur un NAS ou lorsque la recherche approximative est nécessaire.