grocy

• Public demo of the latest stable version (release branch) → https://demo.grocy.info
• Public demo of the current development version (master branch) → https://demo-prerelease.grocy.info

Features

See the website. → https://grocy.info

Questions / Help / Bug Reports / Feature Requests

• General help and usage questions → r/grocy subreddit
• Bug Reports and Feature Requests → Issue Tracker

Please don't send me private messages or call me regarding anything Grocy. I check the issue tracker and the subreddit pretty much daily, but don't provide any support beyond that.

Community contributions

See the website for a list of community contributed Add-ons / Tools. → https://grocy.info/addons

How to install

Checkout Grocy Desktop, if you want to run Grocy without having to manage a webserver just like a normal (Windows) desktop application.

Directly download the latest release - the installation is nothing more than just clicking 2 times "next".

Grocy is technically a pretty simple PHP application, so the basic notes to get it running are:

• Unpack the latest release
• Copy config-dist.php to data/config.php + edit to your needs
• Ensure that the data directory is writable
• The webserver root should point to the public directory
• Include try_files $uri /index.php$is_args$query_string; in your location block if you use nginx
  • Or disable URL rewriting (see the option DISABLE_URL_REWRITING in data/config.php)
• → Default login is user admin with password admin, please change the password immediately (user menu at the top right corner)

Alternatively clone this repository (the release branch always references the latest released version) and install Composer and Yarn dependencies manually.

See the website for more installation guides and troubleshooting help. → https://grocy.info/links

Platform support

• PHP 8.2 or 8.3 (with SQLite 3.34.0+)
  • Required PHP extensions: fileinfo, pdo_sqlite, gd, ctype, intl, zlib, mbstring
  • Recommendation: Benchmark tests showed that e.g. unit conversion handling is up to 5 times faster when using a more recent (3.39.4+) SQLite version.
• Recent Firefox, Chrome or Edge

How