ERP beyond your fridge
- Public demo of the latest stable version (
release
branch) โ https://demo.grocy.info - Public demo of the latest pre-release version (
master
branch) โ https://demo-prerelease.grocy.info
There is the r/grocy subreddit to connect with other grocy users and getting help.
If you've found something that does not work or if you have an idea for an improvement or new things which you would find useful, feel free to open an issue in the issue tracker here.
See the website for a list of community contributed Add-ons / Tools: https://grocy.info/addons
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 is a pain to use 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!
Checkout grocy-desktop, if you want to run grocy without a webserver just like a normal (windows) desktop application.
See https://github.com/grocy/grocy-desktop or directly download the latest release - the installation is nothing more than just clicking 2 times "next"...
Just unpack the latest release on your PHP (SQLite (3.8.3 or higher) extension required, currently only tested with PHP 7.4) enabled webserver (webservers root should point to the public
directory), copy config-dist.php
to data/config.php
, edit it to your needs, ensure that the data
directory is writable and you're ready to go, (to make it writable, maybe use chown -R www-data:www-data data/
). Default login is user admin
with password admin
, please change the password immediately (see user menu).
Alternatively clone this repository (the release
branch always references the latest released version, or checkout the latest tagged revision) and install Composer and Yarn dependencies manually.
If you use nginx as your webserver, please include try_files $uri /index.php;
in your location block.
If, however, your webserver does not support URL rewriting, set DISABLE_URL_REWRITING
in data/config.php
(Setting('DISABLE_URL_REWRITING', true);
).
See the website for further installation guides and troubleshooting help: https://grocy.info/links
See grocy/grocy-docker or linuxserver/docker-grocy for instructions.
Just overwrite everything with the latest release while keeping the data
directory, check config-dist.php
for new configuration options and add them to your data/config.php
where appropriate (the default values from config-dist.php
will be used for not in data/config.php
defined settings). Just to be sure, please empty data/viewcache
.
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 at https://www.transifex.com/grocy/grocy, if your language is incomplete or not available yet.
(Language can be changed in data/config.php
, e. g. Setting('CULTURE', 'it');
)
The pre-release demo is available for any translation which is at least 80 % 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 reached a completion level of 80 % will be included in releases.
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 QuaggaJS, 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:
MMDD
gets expanded to the given day on the current year, if > today, or to the given day next year, if < today, in proper notation- Example:
0517
will be converted to2018-05-17
- Example:
YYYYMMDD
gets expanded to the proper ISO-8601 notation- Example:
20190417
will be converted to2019-04-17
- Example:
YYYYMMe
orYYYYMM+
gets expanded to the end of the given month in the given year in proper notation- Example:
201807e
will be converted to2018-07-31
- Example:
x
gets expanded to2999-12-31
(which I use for products which never expire)- Down/up arrow keys will increase/decrease the date by 1 day
- Right/left arrow keys will increase/decrease the date by 1 week
- Shift + down/up arrow keys will increase/decrease the date by 1 month
- Shift + right/left arrow keys will increase/decrease the date by 1 year
Wherever a button contains a bold highlighted letter, this is a shortcut key.
Example: Button "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 data/plugins/DemoBarcodeLookupPlugin.php
.
Database schema migration is automatically done when visiting the root (/
) route (click on the logo in the left upper edge).
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 config-dist.php
)
- When the file
data/custom_js.html
exists, the contents of the file will be added just before</body>
(end of body) on every page - When the file
data/custom_css.html
exists, the contents of the file will be added just before</head>
(end of head) on every page
When the MODE
setting is set to dev
, demo
or 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. grocy is only my hobby, one I like, but not the only one, and because of that, there are no release dates, no schedules for when anything is ready, it's done when it's done, maybe tomorrow, maybe tomorrow next year, everyone is invited to contribute - I appreciate all ideas and contributions. The progress of a specific bug/enhancement is always tracked in the corresponding issue, at least by commit comment references.
The MIT License (MIT)