Grocy: ERP Beyond Your Fridge for Home Management

Grocy: ERP Beyond Your Fridge for Home Management

Summary

Grocy is a powerful, web-based, self-hosted solution designed to manage your household groceries, chores, and meal planning. It offers an "ERP beyond your fridge" experience, helping users track stock, create shopping lists, and organize daily tasks efficiently. This open-source project empowers you to take control of your home management.

Repository Info

Updated on January 13, 2026
View on GitHub

Tags

grocyself-hostedgroceriesmeal-plannerhousehold-managementerpphpopen-source

Click on any tag to explore related repositories

Introduction

Grocy is an innovative, web-based, and self-hosted solution that brings "ERP beyond your fridge" to your home. Designed as a comprehensive groceries and household management system, Grocy helps you efficiently track your stock, manage shopping lists, plan meals, and organize household chores. It's a powerful tool for anyone looking to streamline their home operations and embrace the "own your data" philosophy.

You can explore Grocy's capabilities through its public demos:

Installation

Grocy offers several flexible installation methods to suit different user preferences. For Windows users seeking a straightforward setup, Grocy Desktop provides a simple, click-and-run experience, eliminating the need to manage a web server. You can directly download the latest Grocy Desktop release.

Alternatively, Grocy can be installed as a standard PHP application. The basic steps involve:

  • Unpacking the latest release.
  • Copying config-dist.php to data/config.php and editing it as needed.
  • Ensuring the data directory is writable.
  • Pointing your web server root to the public directory.
  • The default login is admin with password admin, which should be changed immediately.

For those preferring containerized solutions, an official Docker image is available at Docker Hub. Grocy requires PHP 8.2 or 8.3 with SQLite 3.34.0+ and specific PHP extensions like fileinfo, pdo_sqlite, gd, ctype, intl, zlib, and mbstring.

Key Features and Examples

Grocy provides a rich set of features to manage various aspects of your home:

  • Stock Management: Keep track of all your groceries and household items, including expiration dates and quantities.
  • Shopping Lists: Automatically generate shopping lists based on your stock and meal plans, or create them manually.
  • Meal Planning: Plan your meals for the week, integrating directly with your stock and shopping lists.
  • Chores Management: Organize and track household tasks, ensuring nothing is overlooked.
  • Barcode Integration: Utilize barcode readers or your device's camera for quick product scanning and lookup. Grocy supports external barcode lookup services like Open Food Facts.
  • REST API: A comprehensive REST API allows for integration with other systems, with a Swagger UI instance available at /api.
  • Progressive Web App (PWA): Grocy's web frontend is a responsive PWA, offering a native mobile app-like experience without additional tools.
  • Smart Input Shorthands: Date fields support various shorthands for faster data entry, such as +1m for "one month from today."

Why Use Grocy?

Grocy stands out as an essential tool for modern household management by offering a centralized platform to organize what often feels like disparate tasks. By tracking your inventory, you can significantly reduce food waste, save money, and ensure you always have what you need on hand. Its self-hosted nature gives you complete control over your data, aligning with privacy-conscious principles. Whether you're planning meals, managing chores, or simply keeping an eye on your pantry, Grocy provides the structure and automation to make your home run more smoothly, transforming everyday household logistics into an efficient, manageable system.

Useful Links