Abstract teal and amber illustration of overlapping recipe cards, a meal-planning calendar grid, and a shopping list, representing a self-hosted recipe manager

Mealie

Mealie est un gestionnaire de recettes, planificateur de repas et liste de courses gratuit et auto-hébergé, construit avec un backend FastAPI et un frontend Vue. Sa fonctionnalité phare : un scraper intégré qui, à partir d’une simple URL de recette, récupère automatiquement les ingrédients, les étapes et la photo dans sa propre base de données, sans copier-coller manuel. Il tourne dans un unique conteneur Docker, embarque des sauvegardes automatiques, et couvre plus de 35 langues dès l’installation.

En bref : Mealie est open source sous licence GNU AGPL-3.0, confirmée dans le fichier LICENSE du dépôt GitHub et son badge de licence. La dernière version stable est la v3.19.2, avec plus de 12 500 étoiles sur GitHub. L’image officielle est ghcr.io/mealie-recipes/mealie sur le GitHub Container Registry, et le conteneur écoute sur le port 9000 en interne. Le projet était à l’origine un dépôt solo du développeur hay-kot, désormais maintenu sous l’organisation mealie-recipes.

Qu’est-ce que Mealie ?

Avant Mealie, « gérer ses recettes » voulait souvent dire un dossier de favoris dans le navigateur ou une pellicule photo pleine de captures d’écran. Mealie traite au contraire une collection de recettes comme une vraie base de données. Deux façons d’ajouter une recette. La première : coller une URL et laisser le scraper intégré s’appuyer sur le même balisage schema.org Recipe que publient déjà la plupart des sites de cuisine, pour remplir automatiquement les ingrédients, les étapes et la photo. La seconde : passer par l’éditeur de l’interface, avec support Markdown, pour les recettes de famille qui n’existent que sur papier. À partir de là, un Planificateur de repas hebdomadaire organise ce qui sera cuisiné, et une Liste de courses se génère directement à partir des recettes planifiées en regroupant les articles par rayon. Les Livres de recettes, eux, rassemblent le tout selon le critère qui vous arrange : cuisine, occasion ou régime alimentaire. Les Groupes multi-utilisateurs permettent à tout un foyer de partager la même bibliothèque et le même planning de repas, avec un panneau d’administration pour gérer les inscriptions. Une API ouverte et des Webhooks planifiés complètent le tableau pour qui veut envoyer le planning du jour vers un autre outil auto-hébergé.

Installer Mealie avec Docker

Prérequis : Docker et Docker Compose doivent déjà être installés. Notre guide pour monter votre premier homelab couvre le choix du matériel pour un premier projet Docker.

  1. Enregistrez le docker-compose.yml ci-dessous dans un dossier vide.
  2. Vérifiez le tag de version actuel sur le dépôt GitHub officiel et mettez à jour la ligne image si une version plus récente est sortie.
  3. Renseignez un vrai fuseau horaire et, si le serveur est joignable depuis l’extérieur du réseau local, une BASE_URL.
  4. Lancez le fichier compose depuis ce dossier et ouvrez le port mappé pour créer le premier compte administrateur.
services:
  mealie:
    image: ghcr.io/mealie-recipes/mealie:v3.19.2
    container_name: mealie
    restart: unless-stopped
    ports:
      - "9000:9000"
    deploy:
      resources:
        limits:
          memory: 1000M
    volumes:
      - mealie-data:/app/data/
    environment:
      ALLOW_SIGNUP: "false"
      PUID: 1000
      PGID: 1000
      TZ: Europe/Paris
      BASE_URL: https://mealie.yourdomain.com

volumes:
  mealie-data:
docker compose up -d

Seul le port 9000 doit être exposé côté conteneur ; le port côté hôte de ce mapping peut être remplacé par n’importe quel port libre. Les données, y compris la base SQLite, vivent entièrement dans le volume mealie-data, conformément à la documentation officielle d’installation SQLite, que l’équipe de Mealie recommande pour des installations de 1 à 20 utilisateurs. Un chemin d’installation PostgreSQL séparé existe pour les groupes plus larges ou pour quiconque fait tourner le dossier de données sur du stockage en réseau, là où le verrouillage de fichiers de SQLite peut provoquer des corruptions.

Astuce : épinglez l’image sur un tag de version précis comme v3.19.2 plutôt que sur latest. L’équipe de Mealie le recommande explicitement, pour que les mises à jour se fassent volontairement, après lecture des notes de version, plutôt que silencieusement au prochain redémarrage du conteneur. Fixer une limite mémoire explicite évite aussi à Python de tourner au ralenti avec une consommation RAM plus élevée que nécessaire.

Mealie et Home Assistant

Compatible avec : une intégration Home Assistant officielle qui fait apparaître les plannings de repas dans le calendrier HA et permet aux automatisations de rechercher des recettes ou de déclencher des actions sur la liste de courses.

Quiconque fait déjà tourner Home Assistant peut ajouter Mealie comme intégration native plutôt que comme simple iframe de tableau de bord : les repas de la semaine apparaissent directement dans la vue calendrier de HA, et les données de recettes ou de liste de courses deviennent disponibles pour les automatisations et les scripts. C’est un petit ajout, mais c’est exactement le genre de liant qui donne à un homelab l’impression d’être un système cohérent plutôt qu’un empilement d’applications séparées.

Mealie face à Tandoor Recipes

Tandoor Recipes est la comparaison la plus évidente : lui aussi gratuit, auto-hébergé, et sous licence AGPL-3.0, avec une clause Commons Clause supplémentaire limitant la revente commerciale. Tandoor vise plutôt les utilisateurs avancés, avec une recherche floue basée sur les trigrammes, une gestion des tags par lot, et des fonctionnalités assistées par IA pour reconnaître des photos de recettes ou en extraire les valeurs nutritionnelles. Cette puissance se paie en temps d’installation : le backend Django de Tandoor est construit autour de PostgreSQL et se déploie généralement en pile multi-conteneurs (application, base de données, nginx), davantage de pièces mobiles qu’un premier projet Docker n’en a besoin. Mealie s’en tient à un conteneur unique avec SQLite par défaut, sacrifiant une partie de cet outillage pour utilisateurs avancés au profit d’une installation qui tient quasiment en un seul fichier docker-compose. Un compromis honnête si la priorité est de démarrer vite plutôt que de tout personnaliser.

MealieTandoor Recipes
Déploiement par défautConteneur unique, SQLiteMulti-conteneurs (app + Postgres + nginx)
Import de recettesScraper URL (schema.org Recipe)Scraper URL, des milliers de sites supportés
Planificateur de repas & liste de coursesOui, intégréOui, intégré
Intégration Home AssistantOfficielleNon intégrée nativement
Reconnaissance IA recette/imageNonOui
LicenceAGPL-3.0AGPL-3.0 + Commons Clause
  • Conteneur Docker unique avec SQLite, aucune base de données séparée à gérer
  • Scraper d’import par URL qui fonctionne directement sur les sites de recettes balisés schema.org
  • Intégration Home Assistant officielle pour les plannings de repas et les automatisations
  • Sauvegardes automatiques basées sur des modèles, incluses par défaut
  • Aucun outillage nutrition ou reconnaissance IA intégré, contrairement à Tandoor
  • SQLite par défaut n’est pas sûr sur du stockage en réseau, une migration vers Postgres devient alors nécessaire
  • Système de permissions basique ; non pensé pour être exposé comme page publique

FAQ

Mealie est-il gratuit ?

Oui, le serveur Mealie auto-hébergé est entièrement gratuit et open source sous licence AGPL-3.0, sans fonctionnalité verrouillée derrière un paywall. Une application mobile payante distincte, Mealie.AI, existe sur les stores au sein du même écosystème, mais elle n’est pas nécessaire pour faire tourner ou utiliser le serveur auto-hébergé.

Quel port Mealie utilise-t-il par défaut ?

Le port 9000 à l’intérieur du conteneur. Le port côté hôte dans un fichier docker-compose peut être mappé vers n’importe quel port libre, comme 9925 ou 9000 lui-même.

Mealie a-t-il besoin de Postgres ?

Non. SQLite est la base par défaut et recommandée pour 1 à 20 utilisateurs. PostgreSQL est une alternative prise en charge, surtout pour des groupes plus larges ou quand le volume de données se trouve sur du stockage en réseau, là où SQLite est sujet à des erreurs de verrouillage.

Existe-t-il une application mobile officielle pour Mealie ?

Le projet principal est une application web responsive qui fonctionne très bien depuis le navigateur d’un téléphone. Une application distincte, à la frontière officieuse du projet, nommée Mealie.AI, est référencée sur l’App Store comme assistant de recettes basé sur l’IA et compatible avec un serveur Mealie, mais il s’agit d’un produit à part du projet open source lui-même.

Mealie peut-il importer des recettes automatiquement ?

Oui. Collez une URL de recette et Mealie récupère les ingrédients, les instructions et une photo depuis n’importe quel site publiant un balisage schema.org Recipe standard, ce qui couvre la plupart des blogs de cuisine et sites d’éditeurs modernes.

Mealie s’inscrit dans la même logique de « rester propriétaire de ses données » que le reste d’un homelab. Home Assistant peut afficher son planning de repas directement sur un tableau de bord, et n8n peut automatiser ses sauvegardes ou pousser les mises à jour de la liste de courses vers une appli de chat, deux cas couverts par les guides communautaires de Mealie lui-même. Notre guide pour monter votre premier homelab couvre les bases Docker dont tout ceci dépend.