|Project Name||Stars||Downloads||Repos Using This||Packages Using This||Most Recent Commit||Total Releases||Latest Release||Open Issues||License||Language|
|ERP beyond your fridge - grocy is a web-based self-hosted groceries & household management solution for your home|
|Grocy Docker||284||a day ago||14||mit||Dockerfile|
|ERP beyond your fridge - now containerized - this is the docker repo of https://github.com/grocy/grocy|
|Addon Grocy||223||2 days ago||4||mit||Dockerfile|
|Grocy - Home Assistant Community Add-ons|
|Grocy Desktop||175||5 months ago||mit||C#|
|A (Windows) desktop application wrapper for https://github.com/grocy/grocy|
|Grocy Pyscanner||15||3 years ago||3||mit||Python|
|A little (Python) barcode scanner helper tool for https://github.com/grocy/grocy|
releasebranch) → https://demo.grocy.info
masterbranch) → https://demo-prerelease.grocy.info
Please don't send me private messages or call me regarding grocy help. I check the issue tracker and the subreddit pretty much daily, but don't provide grocy support beyond that.
See the website for a list of community contributed Add-ons / Tools. → https://grocy.info/addons
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".
See the website for some installation guides and troubleshooting help. → https://grocy.info/links
grocy is technically a pretty simple PHP application, so the basic notes to get it running are:
data/config.php+ edit to your needs
datadirectory is writable
try_files $uri /index.php$is_args$query_string;in your location block if you use nginx
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 grocy/grocy-docker or linuxserver/docker-grocy for instructions.
config-dist.phpfor new configuration options and add them to your
data/config.phpwhere appropriate (the default values from
config-dist.phpwill be used for not in
If you run grocy on Linux, there is also
update.sh (remember to make the script executable (
chmod +x update.sh) and ensure that you have
unzip installed) which does exactly this and additionally creates a backup (
.tgz archive) of the current installation in
data/backups (backups older than 60 days will be deleted during the update).
grocy is fully localizable - the default language is English (integrated into code), a German localization is always maintained by me.
You can easily help translating grocy on Transifex if your language is incomplete or not available yet.
The default language can be set in
data/config.php, e. g.
Setting('DEFAULT_LOCALE', 'it'); and there is also a user setting (see the user settings page) to set a different language per user.
The pre-release demo is available for any translation which is at least 70 % complete and will pull the translations from Transifex 10 minutes past every hour, so you can have a kind of instant preview of your contributed translations. Thank you!
Also any translation which once reached a completion level of 70 % (
strings resource) will be included in releases.
RTL languages are unfortunately not yet supported.
A household needs to be managed. I did this so far (almost 10 years) with my first self written software (a C# Windows forms application) and with a bunch of Excel sheets. The software was a pain to use at the end and Excel is Excel. So I searched for and tried different things for a (very) long time, nothing 100 % fitted, so this is my aim for a "complete household management"-thing. ERP your fridge!
See the integrated Swagger UI instance on /api.
Some fields (with a barcode icon above) also allow to select a value by scanning a barcode. It works best when your barcode reader prefixes every barcode with a letter which is normally not part of a item name (I use a
$) and sends a
TAB after a scan.
Additionally it's also possible to use your device camera to scan a barcode by using the camera button on the right side of the corresponding field (powered by Quagga2, totally offline / client-side camera stream processing, please note due to browser security restrictions, this only works when serving grocy via a secure connection (
https://)). Quick video demo: https://www.youtube.com/watch?v=Y5YH6IJFnfc
My personal recommendation: Use a USB barcode laser scanner. They are cheap and work 1000 % better, faster, under any lighting condition and from any angle.
For (productivity) reasons all date (and time) input (and display) fields use the ISO-8601 format regardless of localization. The following shorthands are available:
MMDDgets expanded to the given day on the current year, if > today, or to the given day next year, if < today, in proper notation
0517will be converted to
YYYYMMDDgets expanded to the proper ISO-8601 notation
20210417will be converted to
YYYYMM+gets expanded to the end of the given month in the given year in proper notation
202107ewill be converted to
[+/-]n[d/m/y]gets expanded to a date relative to today, while adding (+) or subtracting (-) the number ofdays/months/years, in proper notation
+1mwill be converted to the same day next month
xgets expanded to
2999-12-31(which is an alias for "never overdue")
Wherever a button contains a bold highlighted letter, this is a shortcut key.
Example: Button "P Add as new product" can be "pressed" by using the
P key on your keyboard.
Products can be directly added to the database via looking them up against external services by a barcode.
This is currently only possible through the REST API.
There is no plugin included for any service, see the reference implementation in
Database schema migration is automatically done when visiting the root (
/) route (click on the logo in the left upper edge).
Please note: Database migrations are supposed to work between releases, not between every commit. If you want to run the current
master branch (which is the development version), you need to handle that (and maybe more) yourself.
If you don't use certain feature sets of grocy (for example if you don't need "Chores"), there are feature flags per major feature set to hide/disable the related UI elements (see
data/custom_js.htmlexists, the contents of the file will be added just before
</body>(end of body) on every page
data/custom_css.htmlexists, the contents of the file will be added just before
</head>(end of head) on every page
MODE setting is set to
prerelease, the application will work in a demo mode which means authentication is disabled and some demo data will be generated during the database schema migration.
When the file
embedded.txt exists, it must contain a valid and writable path which will be used as the data directory instead of
data and authentication will be disabled (used in grocy-desktop).
In embedded mode, settings can be overridden by text files in
data/settingoverrides, the file name must be
<SettingName>.txt (e. g.
BASE_URL.txt) and the content must be the setting value (normally one single line).
Any help is more than appreciated. Feel free to pick any open unassigned issue and submit a pull request, but please leave a short comment or assign the issue yourself, to avoid working on the same thing.
See https://grocy.info/#say-thanks for more ideas if you just want to say thanks.
There is none. The progress of a specific bug/enhancement is always tracked in the corresponding issue, at least by commit comment references.
The MIT License (MIT)