Grocy

Web-based self-hosted groceries & household management solution for your home

app

Alternative to: anylist, bring, sortly, cozi

Website Repository Docs

About Versions (81)

Grocy is a web-based, self-hosted ERP system for your household that tracks what's in your pantry and fridge, warns you before food expires, and keeps a shared shopping list in sync. It also handles recipes and weekly meal planning, chore and task tracking, and equipment servicing schedules, with barcode scanning (camera or USB scanner) and a full REST API tying it all together. It started as a hobby project and is built as a lightweight PHP application that's easy to deploy on your own server.

Grocy Docker Compose example

Self-host Grocy on your own server, homelab, or VPS starting from this Docker Compose example. It runs Grocy in Docker containers using the official lscr.io/linuxserver/grocy:latest image, with persistent volumes and automatic restarts preconfigured. Review the environment variables and adjust them to your setup, save the file as compose.yml (or docker-compose.yml), and start the stack with docker compose up -d.

services:
  grocy:
    image: lscr.io/linuxserver/grocy:latest
    environment:
      # User ID the app runs as (LinuxServer.io convention, controls file ownership on the config volume).
      - PUID=1000
      # Group ID the app runs as.
      - PGID=1000
      # Container timezone, e.g. Europe/London. See the tz database for valid values.
      - TZ=Etc/UTC
    volumes:
      - config:/config
    restart: unless-stopped

volumes:
  config:

Prefer a managed setup? WinterFlow installs, configures, and updates Grocy for you using this same Docker Compose configuration.