Grocy •

Grocy is a household inventory and chore management solution for your family.  Build a recipe book and use it to quickly build shopping lists.  Construct a meal plan and always know what's for dinner next.

Overview

Screen Shot 2025-03-07 at 17.28.42.png

Grocy is a household inventory and chore management solution for your family.  Build a recipe book and use it to quickly build shopping lists.  Construct a meal plan and always know what's for dinner next.

Tryout an Grocy demo.

Media

Screenshots

Grocy v4.4.2

Screen Shot 2025-03-07 at 17.28.42.png Screen Shot 2025-03-07 at 17.28.49.png Screen Shot 2025-03-07 at 17.28.55.png
Screen Shot 2025-03-07 at 17.29.02.png Screen Shot 2025-03-07 at 17.29.07.png Screen Shot 2025-03-07 at 17.29.12.png
Screen Shot 2025-03-07 at 17.29.18.png Screen Shot 2025-03-07 at 17.29.22.png Screen Shot 2025-03-07 at 17.29.27.png
Screen Shot 2025-03-07 at 17.29.45.png Screen Shot 2025-03-07 at 17.30.40.png Screen Shot 2025-03-07 at 17.36.29.png

Setup & Configuration

We need to install the service through Portainer and configure any necessary settings.

Setup & Configuration

Preparation

There are some things we need to do in preparation to install this service.

Volumes

Persistent Data

This is where the service will store its own application data and ensures we can quickly update the service image.

Ensure your user has permissions to access the folder.

Environment

TZ

This is the current time zone formatted using the tz database.

For example: America/Vancouver

PUID

This is the numeric ID of the user account on Debian.  If you are unsure, open a terminal and run:

id -u
PGID

This is the numeric ID of the user account's group on Debian.  If you are unsure, open a terminal and run:

id -g
Setup & Configuration

Installation

The service can be installed through the Portainer web interface. 

Learn about creating a new stack.

Docker Compose

Use the following code to install the service:

---
services:
  grocy:
    image: linuxserver/grocy:latest
    container_name: grocy
    network_mode: bridge
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=America/Vancouver
    volumes:
      # Persistent Data
      - /srv/grocy:/config
    ports:
      - 8181:80
    restart: unless-stopped
Setup & Configuration

Updating

Backup and Re-Deploy the Stack

This service has been partially optimized for running in Docker.  This allows you to re-deploy the stack through Portainer to download the latest updates. 

During major updates, there may be new required settings within their configuration file.  This will require an additional process detailed within their documentation to add the missing settings.

User Manual

Development

This software is released under the MIT license

You can learn more about how to contribute to Grocy through their documentation

The developer also accepts donations.

Resources

Official

LinuxServer.io