grocy

grocy: Manage Groceries and Household Tasks at Home

Grocy is a self-hosted PHP and SQLite web app that treats household management as “ERP beyond your fridge.” Track groceries and stock, plan meals and shopping, and manage household chores through a responsive web interface and REST API.

ActiveBladeMITSelf HostedWeb AppPHP
View on GitHub WebsiteCompare
Stars
9.6k
Forks
815
Stars, last 17 days
+54
Last commit
29 days ago
Contributors
87

Our take

Activeregular commits and releases

Health score

66/100

How it is scored
Activity
56
Community
49
Issues
94
Pull requests
no data

+54 stars in the last 17 days

  • Closes issues faster than 82% of the projects we track
  • More contributors than 75% of the projects we track

Grocy is an actively maintained, feature-rich option for households willing to self-host, though its development depends heavily on one contributor.

Good fit if

  • You want one self-hosted PHP and SQLite app for groceries, meal planning, and household management.
  • You value a REST API, barcode workflows, and configurable feature sets.
  • You can maintain a PHP web application and its writable data directory.

Look elsewhere if

  • You need an officially supported offline-capable mobile app, since the PWA does not provide offline use.
  • You need RTL language support, which the project says is not available.
  • Your adoption policy requires development responsibility to be spread across multiple people.
All health signals
Last commit2026-09-16 (29 days ago)
Commits, last 90 days37
Releases, last 12 months3 (latest v4.7.1, 2026-09-04)
Contributors87 (top contributor: 92% of commits)
Issues closed, last 90 days49 (typically closed in 0 days)
Project age9 years

Checked on 2026-10-16 with the GitHub API.

Overview

Grocy is a self-hosted household management web app built as a PHP application with SQLite. Framed as “ERP beyond your fridge,” it brings groceries and other household tasks into one place, helping people replace spreadsheets or disconnected systems with a shared view of what is in stock and what needs doing.

It is aimed at people managing a home who are comfortable running a web application themselves. The web interface is responsive and can be installed as a PWA, while the REST API exposes the same capabilities for integrations and other tools.

Key Features

  • Track products, household stock, and barcodes.
  • Build and manage shopping lists based on household needs.
  • Plan meals and connect planning with grocery management.
  • Manage chores and other household activities, with feature flags to hide unused areas.
  • Use barcode readers or a device camera to identify products; camera scanning is handled client-side and requires HTTPS.
  • Access the application through a REST API, with an integrated Swagger UI.
  • Set per-user language preferences and contribute translations through Transifex.
  • Install the responsive web frontend as a PWA, without offline functionality.

Use Cases

  • A household can track pantry and refrigerator stock to see what is available before shopping.
  • A person coordinating family meals can plan dishes and prepare a shopping list from the same system.
  • Housemates can use a shared self-hosted app to coordinate chores and household supplies.
  • A technically comfortable user can connect household workflows to other tools through the REST API.

What you need

Detected in the repository

  • Node.js (from package.json)
  • PHP (from composer.json)

License in plain words

MITpermissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the copyright and license notice
  • Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Download the latest release, unpack it, copy config-dist.php to data/config.php, and configure the web server to use the public directory as its document root. The data directory must be writable. See the README and installation guides for full setup and troubleshooting instructions.

Considerations

Grocy requires PHP 8.5 with SQLite 3.40 or newer, plus the PHP extensions listed in the README. The repository reports regular recent commits and releases, and it has closed issues recently, but most code contributions come from one person, creating a project-maintenance dependency. The README describes the project as a hobby project and does not promise a roadmap. The PWA has no offline capability, and RTL languages are not supported. Grocy is licensed under MIT; consult the repository license for the applicable terms.

Found this useful?

Share it with someone who would like grocy.