grocy
A web-based self-hosted ERP system for managing groceries, household inventory, chores, and meal planning.
What is grocy?
Grocy is a web-based self-hosted application that functions as an ERP (Enterprise Resource Planning) system for home management. It helps users track groceries, manage household inventory, plan meals, schedule chores, and maintain shopping lists—all from a single interface. The goal is to reduce waste, improve organization, and streamline daily household tasks.
Individuals or families looking to digitize and optimize household management, particularly those interested in self-hosted solutions, reducing food waste, or integrating barcode scanning and automation into their home routines.
Grocy offers a fully self-hosted, privacy-focused alternative to commercial home management apps, with extensive features like barcode scanning, meal planning, and a comprehensive REST API. Its open-source nature and active community allow for customization and integration without vendor lock-in.
Overview
ERP beyond your fridge - Grocy is a web-based self-hosted groceries & household management solution for your home
Use Cases
Best For
- Managing grocery inventory and tracking expiration dates to reduce food waste
- Planning meals and automatically generating shopping lists from recipes
- Scheduling and tracking recurring household chores and maintenance tasks
- Self-hosting a household management system without relying on cloud services
- Integrating barcode scanners or cameras for quick product lookup and entry
- Automating household workflows via the REST API for custom integrations
Not Ideal For
- Users wanting a cloud-based, no-setup app with automatic mobile sync across devices
- Teams requiring real-time collaborative editing for household tasks (e.g., shared grocery lists with live updates)
- Individuals seeking a minimalist, single-purpose tool for only grocery lists or meal planning
Pros & Cons
Pros
Integrates stock management, meal planning, chores, and shopping lists into a single platform, as showcased in the detailed feature list and screenshots.
Operates entirely on your own infrastructure with no external data sharing, aligning with its philosophy of control and independence.
Supports USB scanners and offline camera scanning via ZXing, with practical tips like prefixing barcodes with '$' for optimal use, as detailed in the README.
Offers a complete API documented with Swagger UI, enabling automation and integration, since the web frontend itself relies on it for all operations.
Can be installed on mobile devices as a progressive web app, providing app-like access without native store dependencies, demonstrated in video demos linked in the README.
Cons
Requires configuring a web server, PHP environment, and database (e.g., SQLite), which can be daunting for users without technical expertise, as outlined in the installation notes.
The PWA lacks offline functionality, making it unusable without an internet connection, as explicitly stated in the README under the PWA section.
Does not yet support right-to-left languages, restricting localization for certain regions, as mentioned under the localization section of the README.
Running the master branch requires manual handling of database migrations and other issues, as noted in the README, making it unsuitable for production use without expertise.
Frequently Asked Questions
Related Projects
MealieMealie is a self hosted recipe manager and meal planner with a RestAPI backend and a reactive frontend application built in Vue for a pleasant user experience for the whole family. Easily add recipes into your database by providing the url and mealie will automatically import the relevant data or add a family recipe with the UI editor
Tandoor RecipesApplication for managing recipes, planning meals, building shopping lists and much much more!
Open Food FactsOpen Food Facts database, API server and web interface - 🐪🦋 Perl, CSS and JS coders welcome 😊 For helping in Python, see Robotoff or taxonomy-editor
Nextcloud Cookbook🍲 A library for all your recipes
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.