Installer Mealie sur un VPS avec Docker Compose
Installez Mealie sur votre VPS avec Docker Compose : importez une recette par URL, créez des menus et listes de courses, puis ajoutez nginx, TLS et les sauvegardes.
Ce que fait un gestionnaire de recettes auto-hébergé
Un gestionnaire de recettes auto-hébergé conserve vos recettes dans une base de données sur un serveur dont vous avez la maîtrise, et Mealie est celui que la plupart des foyers finissent par choisir. Vous collez l’adresse d’une page de recette, puis Mealie en extrait les ingrédients, les étapes, le nombre de portions et le temps de cuisson. Il ignore le récit et la publicité. Votre collection ne contient que la recette.
Le reste de l’application est minimal. Un planning hebdomadaire permet d’y glisser des recettes. Une liste de courses est générée à partir de ce planning. Chaque personne qui cuisine dispose de son propre compte. L’ensemble s’exécute dans un seul conteneur et reste inactif entre deux requêtes. Un VPS modeste suffit donc largement.
Ce guide utilise Docker Compose. Si les termes services: et volumes: ne vous sont pas familiers, commencez par comprendre la structure des fichiers Docker Compose, car tout ce qui suit tient dans un seul fichier Compose et quatre commandes.
Installer Mealie avec Docker Compose
Mealie publie ses images dans le registre de conteneurs GitHub. Au 18 novembre 2026, le tag stable actuel est v3.31.0, publié le 13 novembre. Cette version contient des correctifs de sécurité, et le projet recommande à tout le monde de la mettre à jour. Épinglez une version au lieu d’utiliser latest : avec latest, un docker compose pull un jour quelconque peut vous faire passer à une migration de base de données à laquelle vous n’étiez pas prêt.
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:Deux lignes méritent votre attention avant le démarrage.
Le port est écrit 127.0.0.1:9925:9000, et non 9925:9000. Le conteneur écoute sur 9000 en interne, et l’hôte redirige 9925 vers ce port. Lier cette redirection à l’adresse loopback permet à nginx d’atteindre Mealie, sans rendre le service accessible depuis Internet. Docker ajoute ses propres règles au packet filter : un simple 9925:9000 reste donc accessible depuis l’extérieur, même si votre pare-feu indique que le port est fermé. Il est utile de comprendre cette particularité une fois : consultez pourquoi les ports Docker publiés ignorent ufw.
BASE_URL doit être l’adresse publique exacte que vous utiliserez, avec le schéma et sans slash final. Mealie construit les liens de réinitialisation du mot de passe et les liens d’invitation à partir de cette valeur. Si vous la définissez sur http://localhost:9925, l’invitation envoyée à votre partenaire contiendra un lien qui ne fonctionnera que sur le serveur lui-même.
Démarrez le service et surveillez le premier boot.
sudo docker compose up -d
sudo docker compose logs -f mealieLe premier démarrage crée la base de données SQLite et exécute les migrations, ce qui prend quelques secondes. Lorsque les journaux se stabilisent et n’affichent plus de lignes de migration, vérifiez l’application localement.
curl -I http://127.0.0.1:9925Un 200 OK signifie que l’application fonctionne. Si vous obtenez Connection refused, exécutez sudo docker compose ps -a pour vérifier l’état et le code de sortie du conteneur. Un conteneur arrêté avec le code 137 a reçu SIGKILL ; ce code ne suffit pas à prouver qu’il a dépassé la limite mémoire de 1000M. L’arrêt manuel du conteneur produit également ce code.
Première connexion et désactivation des inscriptions ouvertes
Le compte par défaut est changeme@example.com avec le mot de passe MyPassword. Connectez-vous avec ce compte, puis modifiez immédiatement ces deux éléments, car cette combinaison figure dans la documentation et est donc connue de tous les scanners.
ALLOW_SIGNUP: "false" dans le fichier compose est volontaire. Lorsque les inscriptions sont ouvertes, toute personne qui trouve l’adresse peut créer un compte dans votre boîte à recettes. Lorsqu’elles sont désactivées, vous ajoutez les utilisateurs depuis l’interface d’administration, qui génère un lien d’invitation que vous leur envoyez vous-même. Ce lien est construit à partir de BASE_URL, d’où l’importance de cette valeur. Si vous exécutez plusieurs applications sur le même serveur et souhaitez utiliser un seul mot de passe pour toutes, Mealie peut déléguer son authentification à un fournisseur d’identité externe, comme une instance Authentik auto-hébergée.
Mealie place les utilisateurs dans un foyer, et les foyers sont regroupés dans un groupe. Tous les membres d’un même foyer partagent le planning des repas et la liste de courses, ce qui convient à une famille. La collection de recettes est plus large : les foyers partagent leurs recettes, tags et catégories avec tous les autres foyers du même groupe. Sur un même serveur, des foyers distincts disposent donc de plannings et de listes séparés, mais utilisent les mêmes recettes. Cela convient aussi à une colocation où personne n’est d’accord sur les anchois. Si les utilisateurs ont besoin de collections entièrement séparées, attribuez-leur des groupes distincts, car rien n’est partagé entre les groupes.
L’importateur, raison principale d’utiliser Mealie
Ouvrez la collection de recettes, choisissez de créer une recette à partir d’une URL, puis collez un lien. Mealie récupère la page et recherche les données de recette structurées, c’est-à-dire le bloc lisible par machine que la plupart des sites de recettes intègrent pour les moteurs de recherche. Lorsque ce bloc est présent, l’importation est propre et immédiate.
Si vous configurez un fournisseur d’IA, vous pouvez également importer une image ou du texte brut que vous collez, notamment la photographie d’une page de livre de cuisine. L’importation d’images nécessite un fournisseur capable de lire les images. Sans fournisseur, ces importations ne sont pas disponibles. Elles suivent un traitement plus lent et doivent être vérifiées ensuite, car une fraction manuscrite est facile à mal interpréter.
Les importations en masse s’effectuent depuis le même écran : collez une liste d’adresses, une par ligne, et Mealie les traite en arrière-plan. Une collection de deux cents favoris est ainsi transférée en une seule session.
Plans de repas et liste de courses
Le planificateur de repas est un calendrier. Faites glisser une recette sur un jour pour la planifier. Ajoutez les recettes planifiées à une liste de courses pour en regrouper les ingrédients. Pour combiner les doublons, commencez par créer les aliments et les unités dans Manage Data, activez les quantités d’ingrédients pour chaque recette, puis analysez ses ingrédients afin de les associer à ces aliments et unités. Ainsi, deux recettes qui demandent des oignons produisent une seule ligne au lieu de deux.
La liste est une page actualisée en direct sur votre téléphone, dans le magasin. Comme elle est hébergée sur votre propre serveur, tous les membres du foyer voient la même liste au même moment. Lorsqu’une personne coche le lait, il disparaît de l’écran des autres.
Mettre nginx et TLS devant
Dans cette configuration, Mealie utilise HTTP en clair. Il prend également en charge TLS via TLS_CERTIFICATE_PATH et TLS_PRIVATE_KEY_PATH. Terminez TLS dans nginx, placé devant Mealie. Créez d’abord un enregistrement DNS de type A pointant vers votre serveur, car l’étape de création du certificat vérifie ce nom.
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 nginxnginx -t affichant syntax is ok et test is successful est l’étape de validation. Rechargez nginx uniquement après sa réussite, car le rechargement d’une configuration incorrecte laisse l’ancienne configuration active et masque l’erreur jusqu’au prochain redémarrage.
client_max_body_size 64M est nécessaire, car la valeur par défaut de nginx est de 1 MB. L’envoi d’une photo de recette ou la restauration d’une sauvegarde depuis le navigateur transmet un corps plus volumineux. Sans cette directive, nginx renvoie 413 Request Entity Too Large, et non Mealie. Les journaux de l’application ne contiennent alors aucune information.
Créez ensuite le certificat. Cette étape et son timer de renouvellement sont expliqués dans créer un certificat Let's Encrypt pour nginx avec certbot.
sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d recipes.example.comCertbot réécrit le server block pour écouter sur 443 et ajoute une redirection depuis le port 80. Ouvrez le site avec https:// et vérifiez que le navigateur accepte le certificat. Si Mealie se charge, mais que ses propres liens vous redirigent vers http://, alors BASE_URL contient encore http. Corrigez cette valeur, puis exécutez sudo docker compose up -d pour recréer le conteneur avec la nouvelle valeur.
Mealie ne fonctionne pas sous un sous-chemin tel que example.com/recipes, car le frontend ne peut pas être servi depuis un sous-chemin. Utilisez un sous-domaine.
Sauvegardes et fonctionnement réel d’une restauration
Tout ce que Mealie gère se trouve dans /app/data/ à l’intérieur du conteneur. Il s’agit du volume mealie-data. Copiez ce volume pour sauvegarder simultanément les recettes, les images et la base de données. La documentation de Mealie indique que l’arrêt du conteneur, suivi de la copie de ce dossier, constitue la meilleure méthode pour sauvegarder une installation SQLite.
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 mealieLe nom du volume porte le nom du projet en préfixe, et le nom du projet correspond au répertoire qui contient le fichier Compose. Depuis /srv/mealie, le volume est mealie_mealie-data. C’est pourquoi la première commande est docker volume ls : utilisez le nom qu’elle affiche, et non celui indiqué dans ce guide. Il est important d’arrêter d’abord le conteneur, car SQLite est assez souvent en train d’écrire pour qu’une copie à chaud puisse être restaurée illisible.
Mealie possède également une page de sauvegarde dans l’interface d’administration. Elle écrit une archive zip contenant la base de données sous la forme database.json. Une archive peut être restaurée dans une instance exécutant la même version ou une version plus récente de Mealie. Pour migrer vers un autre serveur, exécutez la même version épinglée sur le nouveau serveur lors de la copie du volume, ou restaurez l’archive dans la même version ou une version plus récente. Une restauration est destructive par conception : elle supprime la base de données actuelle avant de charger l’archive et ne peut pas être annulée. Vous êtes déconnecté à la fin de l’opération.
Aucune de ces copies ne constitue une sauvegarde tant qu’elle reste sur le même serveur. Envoyez régulièrement l’archive vers un autre emplacement. C’est précisément le rôle des sauvegardes chiffrées hors serveur avec restic.
Mise à jour de Mealie
cd /srv/mealie
sudo nano docker-compose.yml
sudo docker compose pull
sudo docker compose up -d
sudo docker compose logs -f mealieAugmentez la version épinglée dans le fichier, puis téléchargez la nouvelle image et recréez le conteneur. Les migrations s’exécutent au premier démarrage de la nouvelle image. Copiez le volume avant de changer de version majeure, car une migration qui échoue à mi-parcours peut laisser une base de données que l’ancienne image ne pourra plus ouvrir. Lisez les notes de version pour toutes les versions comprises entre votre version actuelle et la nouvelle.
Lorsque l’importateur échoue
Certains sites ne publient aucune donnée structurée de recette. Mealie importe alors un titre avec une liste d’ingrédients vide. Sans fournisseur d’IA, vous ne pouvez pas résoudre ce problème par la configuration. Collez plutôt le texte de la recette manuellement. Lorsqu’un fournisseur est configuré, Mealie transmet le contenu de la page au modèle si le scraper ne trouve rien. Le résultat doit être vérifié par rapport à l’original, comme tout autre import effectué avec une IA.
D’autres échecs sont dus à la protection contre les bots placée devant le site de recettes. Celle-ci renvoie une page de challenge à Mealie au lieu de la recette. Mealie se fait déjà passer pour un navigateur et fait tourner son user agent pour limiter ce problème. Lorsqu’un site refuse toujours l’accès, les options documentées consistent à faire passer le scraper par un proxy bénéficiant d’une meilleure réputation d’adresse, ou à exécuter une instance de FlareSolverr qui résout le challenge dans un vrai navigateur. Ces deux options sont facultatives et se configurent au moyen de variables d’environnement sur le conteneur.
Un import qui échoue parce que votre serveur ne peut pas du tout joindre le site correspond à un autre problème. Testez l’accès depuis le serveur avec curl -I https://the-site.example/recipe et lisez la ligne d’état avant d’accuser le scraper. Depuis la v3.26.0, Mealie refuse également de récupérer des contenus depuis des adresses privées ou internes. Une page de recette hébergée sur votre propre réseau ne sera donc pas importée tant que vous n’aurez pas ajouté son hôte à la variable d’environnement HTTP_ALLOW_LIST.
Où cette application s’insère
Mealie est une bonne première application auto-hébergée pour un foyer, car les personnes avec qui vous vivez l’utiliseront sans que vous ayez à le leur demander. C’est le même type d’usage que votre propre photothèque avec Immich, mais en beaucoup plus léger. L’application s’inscrit aussi dans la liste plus large des services qui valent la peine d’être auto-hébergés cette année. Un seul petit serveur peut héberger les deux. Immich n’est pas le seul candidat pour ce second usage. Si vous hésitez encore, les besoins minimaux en mémoire et les commandes de sauvegarde de PhotoPrism et Immich diffèrent suffisamment pour mériter une lecture avant de consacrer le reste du disque à cette installation. Si le foyer conserve aussi ses projets et ses notes, en plus de ses repas, un espace de travail AFFiNE auto-hébergé repose une nouvelle fois sur le même exercice avec un fichier Compose. Il nécessite toutefois quatre conteneurs et nettement plus de mémoire que Mealie. Vérifiez donc d’abord les ressources encore disponibles sur le serveur. Si le foyer veut aussi suivre ses entraînements, en plus de ses repas, openGym conserve les séances d’entraînement et utilise le même tag épinglé, le même fichier Compose et le même certificat que ceux que vous venez de configurer. Le moment qui suit le dîner a aussi sa propre déclinaison, puisque Halcyon transforme une bibliothèque Jellyfin existante en vidéoclub des années 1990 que vous pouvez parcourir, avec un conteneur supplémentaire placé devant un service que vous utilisez déjà, plutôt qu’une nouvelle base de données à sauvegarder. Tout ce qui appartient à cette famille n’est pas une application pour foyer. Si cette même habitude doit un jour servir au travail, un service d’assistance Chatwoot auto-hébergé reprend le même tag épinglé et le même certificat, avec Postgres, Redis et un envoi de courriers fonctionnel en arrière-plan. Il s’agit d’un service beaucoup plus lourd qu’une application de recettes et il mérite son propre serveur.
FAQ
Pourquoi l’importation d’une URL de recette échoue-t-elle ?
Deux causes sont fréquentes. Soit la page ne publie aucune donnée de recette structurée : le scraper ne trouve rien et, sauf si un fournisseur d’IA est configuré pour lire la page à sa place, vous obtenez un titre sans ingrédients. Soit une couche de protection contre les bots placée devant le site renvoie une page de défi au lieu de la recette. Dans le second cas, vous pouvez configurer Mealie pour utiliser un proxy avec une meilleure réputation d’adresse, ou une instance FlareSolverr auto-hébergée qui résout le défi dans un vrai navigateur. Vérifiez d’abord que votre serveur peut atteindre la page avec curl -I avant de modifier quoi que ce soit.
Ai-je besoin de PostgreSQL ou SQLite suffit-il ?
SQLite suffit pour un usage familial et c’est le choix par défaut. Passez à PostgreSQL lorsque le répertoire de données se trouve sur un stockage attaché au réseau, car SQLite sur un système de fichiers réseau produit des erreurs de base de données verrouillée et peut corrompre le fichier. Avec PostgreSQL, les restaurations nécessitent que l’utilisateur de la base de données soit un superuser, car la restauration supprime tout avant de charger l’archive.
Puis-je utiliser Mealie sans nom de domaine ?
Oui, sur votre propre réseau. Définissez BASE_URL sur l’adresse que vous saisirez réellement, par exemple http://192.168.1.20:9925, modifiez le mapping de port en 192.168.1.20:9925:9000 avec l’adresse LAN de votre serveur, puis ignorez nginx. Exécutez sudo docker compose up -d pour appliquer les deux modifications. Le mapping 127.0.0.1:9925:9000 d’origine n’accepte que les connexions provenant de l’hôte Docker. Les liens d’invitation et de réinitialisation du mot de passe sont construits à partir de BASE_URL ; une valeur incorrecte produit donc des liens que personne d’autre ne peut ouvrir. Ne l’exposez pas à Internet en HTTP non chiffré, car l’identifiant de connexion est alors envoyé en clair.
Comment donner à ma famille ses propres comptes ?
Laissez ALLOW_SIGNUP défini sur "false" et ajoutez les personnes depuis la zone d’administration. Cela génère un lien d’invitation que vous leur envoyez. Placez dans le même foyer toutes les personnes qui partagent une cuisine afin qu’elles partagent le planning des repas et la liste de courses. Les recettes sont partagées avec tous les foyers du groupe dans tous les cas. Les personnes qui ont besoin de collections séparées doivent donc appartenir à des groupes distincts.
Que deviennent mes recettes si j’arrête d’utiliser Mealie ?
Vous pouvez les extraire. La sauvegarde d’administration écrit vos données au format JSON, et Mealie peut également exporter les recettes dans des fichiers JSON, qui restent lisibles dans n’importe quel éditeur de texte, sans aucun logiciel particulier. Effectuez un export avant d’en avoir besoin et vérifiez que vous pouvez l’ouvrir.