# Grocy Household Management

> Grocy ERP for household management with inventory, chores, and recipes.

- Category: Home Lab & Self-Hosting
- Difficulty: beginner
- Components: grocy
- Tags: grocy, household, inventory, groceries, meal-planning
- Source: https://docker.recipes/homelab/grocy-household

## Overview

Grocy is a web-based ERP solution designed specifically for household management, originally developed by Bernd Bestel in 2017 to bring enterprise resource planning concepts to home environments. Unlike commercial household apps, Grocy provides comprehensive inventory tracking, expiration date management, shopping list automation, recipe management, and chore scheduling in a self-hosted package that keeps your household data completely private. The application runs as a PHP-based web interface with SQLite database backend, making it lightweight yet powerful enough to handle complex household logistics.

This Docker stack deploys Grocy using the LinuxServer.io container image, which provides automatic updates, proper file permissions, and optimized configuration for home server environments. The containerized setup isolates Grocy from your host system while maintaining persistent data storage for your household inventory, recipes, and historical consumption patterns. The stack is configured to run on port 9283 with timezone synchronization and user/group ID mapping for proper file access.

This configuration is ideal for families wanting to reduce food waste, individuals managing large pantries or freezers, meal prep enthusiasts, and anyone seeking to digitize their household management workflow. The combination of barcode scanning capabilities, expiration tracking, and automated shopping lists makes Grocy particularly valuable for households serious about inventory optimization and budget management.

## Features

- Comprehensive inventory management with barcode scanning support for easy product entry
- Automatic expiration date tracking with customizable warning notifications
- Smart shopping list generation based on minimum stock levels and consumption patterns
- Built-in recipe manager with ingredient calculation and meal planning calendar
- Household chore scheduling and tracking system with recurring task support
- Stock location management for tracking items across multiple storage areas
- Consumption history analytics to identify usage patterns and optimize purchasing
- Multi-user support with different permission levels for family members

## Use cases

- Large families tracking pantry inventory and reducing food waste through expiration monitoring
- Meal prep enthusiasts managing bulk ingredient purchases and recipe scaling
- Households with multiple storage locations needing centralized inventory tracking
- Budget-conscious families optimizing grocery shopping through consumption analytics
- Shared living situations requiring chore assignment and completion tracking
- Home cooks building digital recipe collections with automatic shopping list integration
- Individuals managing special dietary requirements with detailed ingredient tracking

## Prerequisites

- Docker and Docker Compose installed on your system
- Minimum 512MB RAM available for the Grocy container
- Port 9283 available and not conflicting with other services
- Basic understanding of web-based inventory management concepts
- Mobile device or barcode scanner for product entry (optional but recommended)
- TZ environment variable configured for accurate expiration date calculations

## docker-compose.yml

```yaml
services:
  grocy:
    image: linuxserver/grocy:latest
    container_name: grocy
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=${TZ}
    volumes:
      - grocy_config:/config
    ports:
      - "9283:80"
    restart: unless-stopped
    networks:
      - grocy-network

volumes:
  grocy_config:

networks:
  grocy-network:
    driver: bridge
```

## .env

```bash
# Grocy
TZ=UTC
```

## Usage notes

- UI at http://localhost:9283
- Default login: admin / admin
- Change password after first login
- Barcode scanning support
- Meal planning and recipes

## Troubleshooting

- Grocy shows 'Database is locked' error: Stop the container, check for crashed PHP processes, and restart with docker-compose restart grocy
- Barcode scanning not working properly: Ensure your camera has proper permissions and try using the manual UPC entry as fallback
- Shopping list not updating automatically: Check minimum stock levels are set correctly for products and verify consumption tracking is enabled
- Recipe ingredient calculations are incorrect: Verify that product units match recipe units and check quantity unit factor settings
- Chore notifications not appearing: Confirm timezone settings match your location and check that due date calculations are properly configured
- File permission errors on config directory: Ensure PUID and PGID match your host user's ID values using 'id' command

