Grocy

Grocy

WHAT IS IT?

Grocy is an "ERP beyond your fridge": a self-hosted web app that manages the stock and the housekeeping of a home. You scan groceries when they come in, Grocy tracks quantities and expiration dates, decrements stock as you consume, and warns you before things go bad. Around that core sit recipes, meal planning, chores, tasks, equipment maintenance and even battery tracking.

WHY IS IT INTERESTING?

  • Stock is the heart of the system: purchases, consumption, expiration dates and locations are tracked unit by unit, with conversions (buy by the kilo, consume by the serving).
  • Automatic shopping list: set a minimum stock per product and Grocy fills the list on its own, while meal planning adds any missing ingredients.
  • Barcodes and Open Food Facts: USB scanner or phone camera, with external lookup to pre-fill the product sheet instead of typing everything by hand.
  • Waste-aware recipes: Grocy cross-checks recipes against actual stock and tells you what you can cook right now, prioritizing what expires soonest.
  • Full REST API: documented with Swagger, so you can wire in Home Assistant, an ESP32 with a barcode reader or your own scripts.
  • Simple deployment: PHP plus SQLite, no separate database server. Docker, LinuxServer.io or plain PHP hosting, your call.

USE CASES

  • Stop throwing food away: see what expires this week and cook accordingly
  • Generate the shopping list straight from the week's meal plan
  • Track recurring home maintenance (filters, descaling, battery swaps)
  • Drive stock from a Home Assistant dashboard through the API
  • Share grocery stock management across a flatshare or a community space