Grocy¶

Grocy is a web-based self-hosted groceries & household management solution for your home.

Note

For this guide you should be familiar with the basic concepts of

Domains

License¶

Grocy is released under the MIT license.

Prerequisites¶

Your URL needs to be setup:

[isabell@stardust ~]$ uberspace web domain list
isabell.uber.space
[isabell@stardust ~]$

Installation¶

Download¶

Download grocy.

[isabell@stardust ~]$ cd /var/www/virtual/$USER
[isabell@stardust isabell]$ wget https://releases.grocy.info/latest -O grocy_latest.zip
[…]
Saving to: ‘grocy_latest.zip’

grocy_latest.zip        100%[===============================>]  54,83M  12,6MB/s    in 4,4s

2020-08-26 12:09:31 (12,5 MB/s) - ‘grocy_latest.zip’ saved [57489683/57489683]
[isabell@stardust isabell]$

Extract¶

Unpack the downloaded grocy release

[isabell@stardust isabell]$ unzip -q grocy_latest.zip -d grocy
[isabell@stardust isabell]$ rm grocy_latest.zip
[isabell@stardust isabell]$

Expose¶

If you want to only host grocy on your Uberspace (best practice since Uberspace 7) you should link your DocumentRoot to grocy’s public folder:

[isabell@stardust isabell]$ rm -f html/nocontent.html; rmdir html
[isabell@stardust isabell]$ ln -s grocy/public html
[isabell@stardust isabell]$

If you instead want to host grocy alongside other applications, just leave the html folder and create the link inside of it, like this:

[isabell@stardust isabell]$ ln -s public html/grocy
[isabell@stardust isabell]$

Please note that this will require further tweaking in the config file.

Configure¶

Copy the default config file to data/config.php and edit it to your liking

[isabell@stardust isabell]$ cd grocy
[isabell@stardust grocy]$ cp config-dist.php data/config.php
[isabell@stardust grocy]$ nano data/config.php
[isabell@stardust grocy]$

You will probably want to change the CURRENCY to EUR and CULTURE to de.

If you decided to host your grocy installation in a sub folder, also change the BASE_URL to your full url, e.g. http://isabell.uber.space/. The config file provide’s more help about this in it’s comments, so make sure to read them.

Finishing installation¶

Point your Browser to your installation URL (e.g. https://isabell.uber.space). This will take a moment, as grocy will need to create the default database at first.

When prompted for a login, use admin for both username and password.

Warning

Change the default password as soon as possible, as it poses a security risk. If you don’t, anyone can access your data.

Updates¶

Note

Check the update feed regularly to stay informed about the newest version.

Grocy comes with a handy update script, so just run this and copy the public files to html again.

[isabell@stardust ~]$ cd /var/www/virtual/$USER/grocy
[isabell@stardust grocy]$ bash update.sh
[isabell@stardust grocy]$

Tested with Grocy 2.7.1, Uberspace 7.7.4.0

Written by: Jonas <https://github.com/jfowl>