grocy

ERP beyond your fridge - Grocy is a web-based self-hosted groceries & household management solution for your home

⭐ 9,015 stars on GitHub · 🍴 759 forks · 📜 License: mit · 💻 Language: JavaScript

What is grocy?

Household inventory apps usually stop at shopping lists; Grocy goes much further by treating your pantry, fridge, chores, batteries, and meal planning like a lightweight home ERP. Its real differentiator is that it brings barcode-driven stock management and expiry tracking into a self-hosted web app you fully control.

Main components

• Stock management for groceries, household items, quantities, locations, and best-before dates
• Shopping lists generated from low-stock products, recipes, and manual planning
• Meal planner and recipe management tied directly into inventory consumption
• Barcode scanner support via USB readers or device camera, with offline client-side scanning
• Chore tracking, task planning, equipment management, and battery tracking for household operations
• REST API with integrated Swagger UI for automation, integrations, and custom dashboards

Clear use cases

• Track pantry and fridge inventory so you know what you have, where it is, and when it expires
• Build shopping lists automatically from minimum stock levels instead of checking cupboards manually
• Plan weekly meals and connect recipes to real ingredient consumption
• Reduce food waste by prioritizing items close to their best-before date
• Manage recurring household chores, appliance maintenance, and battery replacements in one place

Grocy is best understood as a serious tool for people who already think in systems. It is not just a prettier grocery checklist; it models products, locations, quantities, units, recipes, stock transactions, and household tasks with enough structure to make automation useful. The web frontend runs on a straightforward PHP and SQLite stack, and there are Docker options available through community-maintained images, so it fits comfortably into a typical homelab.

The biggest strength is end-to-end household inventory control — Grocy connects buying, storing, cooking, consuming, and replenishing in a way most commercial grocery apps do not. SaaS shopping apps are usually optimized for quick list sharing or retailer integration; Grocy is optimized for owning your data and making your home inventory queryable, auditable, and automatable. The REST API is a major advantage if you want to wire it into Home Assistant, barcode workflows, custom notifications, or dashboards.

There are trade-offs. Grocy asks for setup discipline: products, units, locations, barcodes, and habits need to be maintained, otherwise the system becomes stale. The UI is functional rather than consumer-polished, and non-technical household members may need onboarding. But if you are willing to scan items in and out, define stock rules, and use the recipe planner, the payoff is real: fewer duplicate purchases, less expired food, and a much clearer view of household supplies.

Best for homelab users, self-hosting families, meal planners, and data-minded households that want a private, API-friendly alternative to commercial grocery and chore apps.

Topics: the project is tagged with popular topics:

• 🏷️ erp
• 🏷️ food
• 🏷️ groceries
• 🏷️ grocy
• 🏷️ home
• 🏷️ meal-planner
• 🏷️ ownyourdata
• 🏷️ php
• 🏷️ self-hosted

📸 Screenshots

Quick install

See the README for detailed install instructions. Most projects support Docker — if the repo has a Dockerfile, use:

git clone https://github.com/grocy/grocy.git
cd grocy
docker build -t grocy .
docker run -d -p 8080:8080 grocy

Minimum system requirements

⚡ Deploy fast on VSIS

Use the VSIS VPS Mini 1GB RAM / 1 vCPU / 15GB SSD (~70k/tháng) plan from VSIS.NET — high-speed VN-based VPS, 24/7 support, ideal for running grocy smoothly.

🎯 Benefits:

• One-command docker compose up -d deploy in 2 minutes
• Dedicated IPv4, root access, unmetered domestic bandwidth
• Daily snapshot backup
• Free install assistance from the VSIS team

👉 See matching VPS plans at vsis.net

Resources

• 🔗 GitHub: grocy/grocy
• 🌐 Homepage: https://grocy.info
• 📚 Official docs: see README in the repo
• 💬 Community: GitHub Issues + Discussions

Article compiled from GitHub data on 05/05/2026. Star/fork counts may have changed — see live numbers via the GitHub link.