Le stock alimentaire au centre d'un ERP domestique
Dans Grocy, chaque achat crée une entrée de stock avec sa date d'échéance, chaque consommation la retire, et la vue du stock signale ce qui est périmé, ce qui arrive à échéance et ce qui passe sous son stock minimum, le seuil qui remplit la liste de courses. Le projet se présente comme un « ERP beyond your fridge » : recettes, planning de repas, corvées, tâches, suivi des piles et notices d'appareils se greffent sur ce stock. C'est une application web PHP sur SQLite, sous licence MIT.
L'inventaire des objets durables de la maison, garanties comprises, relève plutôt de Homebox, qui part de l'objet et non du stock.
Recettes notées selon ce qui périme, produits créés au scan
- Due Score des recettes : chaque recette indique si tout est en stock, et le Due Score désigne celles qui écoulent les produits proches de l'échéance ou déjà dépassés.
- Douchette ou caméra : le scan par caméra (bibliothèque ZXing) se fait dans le navigateur. Un code-barres inconnu est cherché sur Open Food Facts, plugin actif par défaut, pour créer la fiche produit. Le mainteneur, lui, conseille une douchette laser USB.
- Un stock détaillé : emplacements, historique des prix, produits entamés ou congelés, conversions entre unités d'achat, de consommation et de stock.
- L'interface tourne sur l'API publique : le frontend passe pour presque tout par l'API REST documentée en Swagger sur
/api, donc ce qui se fait à l'écran se fait aussi par script. - Modules masquables, connexion au choix : un drapeau par grand module (corvées, piles, équipement...) le cache, et la connexion passe par les comptes de Grocy, un en-tête du reverse proxy ou un annuaire LDAP.
Repas de la semaine et corvées réparties dans le foyer
- Planifier les repas à partir des recettes et envoyer d'un clic les ingrédients manquants sur la liste de courses
- Attribuer les corvées aux membres du foyer et partager le calendrier de Grocy par un lien iCal
- Noter la dernière recharge de chaque jeu de piles
- Faire tourner Grocy sur un PC Windows sans serveur web avec Grocy Desktop, aussi proposé sur le Microsoft Store
Un foyer par instance, PHP 8.5 obligatoire
Une instance décrit une seule maison. À la demande de gérer plusieurs foyers (issue #644), Bernd Bestel a répondu en 2023 que ce découpage n'arriverait sans doute jamais, car il faudrait repenser tout le backend et le frontend. Il renvoie à plusieurs instances, ou à des emplacements et des champs personnalisés. Plusieurs comptes peuvent en revanche s'y connecter.
PHP 8.5 est le seul environnement supporté. C'est le cas depuis la 4.6.0 du 6 mars 2026 : PHP 8.5, SQLite 3.40 ou plus, et sept extensions (fileinfo, pdo_sqlite, gd, ctype, intl, zlib, mbstring). Aucun serveur de base de données n'est requis. L'image Docker de LinuxServer.io, l'add-on Home Assistant et les applications mobiles sont, selon le site, des contributions communautaires.
La caméra exige HTTPS, et rien ne marche hors ligne. Le navigateur n'autorise le scan par caméra qu'en https://, et l'interface installable (PWA) n'offre aucun usage hors connexion. Le compte par défaut est admin / admin, à changer immédiatement selon le README.
Un projet hobby, sans feuille de route. Grocy est le projet personnel de Bernd Bestel depuis 2017. Le support se limite au tracker GitHub et au subreddit r/grocy. À la rubrique Roadmap, le README répond : « There is none. »
Dernière version : 4.7.1, du 4 septembre 2026. Elle suit la 4.7.0 du 28 août, qui a réorganisé le middleware d'authentification (réglage AUTH_CLASS à revoir) et invalidé toutes les sessions web. La 4.6.0 était sortie près d'un an après la 4.5.0. Les migrations de schéma ne sont prévues qu'entre deux releases : suivre la branche master revient à les gérer soi-même. Le dernier commit date du 16 septembre 2026.