Grocy Household Management

Key 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

Common Use Cases

• 1Large families tracking pantry inventory and reducing food waste through expiration monitoring
• 2Meal prep enthusiasts managing bulk ingredient purchases and recipe scaling
• 3Households with multiple storage locations needing centralized inventory tracking
• 4Budget-conscious families optimizing grocery shopping through consumption analytics
• 5Shared living situations requiring chore assignment and completion tracking
• 6Home cooks building digital recipe collections with automatic shopping list integration
• 7Individuals 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

1services: 
2  grocy: 
3    image: linuxserver/grocy:latest
4    container_name: grocy
5    environment: 
6      - PUID=1000
7      - PGID=1000
8      - TZ=${TZ}
9    volumes: 
10      - grocy_config:/config
11    ports: 
12      - "9283:80"
13    restart: unless-stopped
14    networks: 
15      - grocy-network
16
17volumes: 
18  grocy_config: 
19
20networks: 
21  grocy-network: 
22    driver: bridge

.env Template

1# Grocy
2TZ=UTC

Usage Notes

Quick Start

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  grocy:
5    image: linuxserver/grocy:latest
6    container_name: grocy
7    environment:
8      - PUID=1000
9      - PGID=1000
10      - TZ=${TZ}
11    volumes:
12      - grocy_config:/config
13    ports:
14      - "9283:80"
15    restart: unless-stopped
16    networks:
17      - grocy-network
18
19volumes:
20  grocy_config:
21
22networks:
23  grocy-network:
24    driver: bridge
25EOF
26
27# 2. Create the .env file
28cat > .env << 'EOF'
29# Grocy
30TZ=UTC
31EOF
32
33# 3. Start the services
34docker compose up -d
35
36# 4. View logs
37docker compose logs -f

One-Liner

Run this command to download and set up the recipe in one step:

1curl -fsSL https://docker.recipes/api/recipes/grocy-household/run | bash

Troubleshooting