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


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


Grocy is released under the MIT license.


Your URL needs to be setup:

[isabell@stardust ~]$ uberspace web domain list
[isabell@stardust ~]$



Download grocy:

[isabell@stardust ~]$ cd /var/www/virtual/$USER
[isabell@stardust isabell]$ wget -O
Saving to: ‘’        100%[===============================>]  54,83M  12,6MB/s    in 4,4s

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


Unpack the downloaded grocy release:

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


Remove the default page from your DocumentRoot and link it 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]$


Copy the default config file to data/config.php:

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

Now use your preferred text editor and edit data/config.php to your liking.

You will probably want to change the CURRENCY and CULTURE to your language code (e.g. EUR for Euro and de for Germany).

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. 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.


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



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
[isabell@stardust grocy]$

Tested with Grocy 3.3.2, Uberspace 7.13.0, and PHP 8.1

Written by: Jonas <>