Grocy Household Management ERP

This is a repackaged open source software product wherein additional charges apply for cloudimg support services.

## Overview

Grocy is an open source, self-hosted groceries and household management solution - an ERP for your home. It tracks your food stock and best-before dates, manages your shopping list, stores your recipes and meal plans, and schedules your recurring chores, batteries, and equipment, all from one clean web interface backed by a full REST API. This AMI delivers Grocy 4.5.0 fully installed and configured so your household management service is running within minutes of launch - no manual package installation, database setup, or web server configuration required.

## Why This AMI Over Self-Install or Docker

• Zero configuration time: Skip hours of manual PHP, nginx, and SQLite setup. The application stack, database schema, and web server are pre-configured and tested as a unit.
• Unique credentials per instance: Unlike default Docker images that ship with admin/admin, every instance generates a fresh administrator password on first boot with no shared or default credentials.
• Self-contained storage: SQLite eliminates the need to provision and manage a separate database server, reducing operational complexity and cost.
• Dedicated human support: Get expert help from cloudimg engineers instead of relying solely on community forums.

## Application Stack

• PHP 8.3 with OPcache and all required Grocy extensions
• nginx web server serving the application front controller
• SQLite storage on a dedicated, independently resizable EBS data volume
• No separate database server to provision or manage

## Secure First Boot

On first boot, a one-shot service generates a fresh Grocy administrator password unique to that instance and writes credentials to a root-only file. No shared or default credentials ship in the image, and no demo data is generated. SSH access is key-based only.

## Integrations

Grocy's full REST API enables integration with popular tools and services:

• Barcode Buddy: Scan groceries directly into your Grocy inventory using a barcode reader or smartphone app.
• Home Assistant: Connect Grocy to your home automation platform for stock-level alerts, shopping list synchronization, and chore tracking dashboards.
• Amazon S3: Configure scheduled SQLite database backups to an S3 bucket for durable off-instance storage.
• Amazon CloudWatch: Forward nginx and application logs for centralized monitoring and alerting.

## Example Scenario

A four-person household launches the AMI, retrieves the generated admin password, and begins scanning groceries at purchase using Barcode Buddy. Grocy tracks best-before dates and sends expiry alerts before food goes to waste. Each week, the family reviews the auto-generated shopping list, plans meals from stored recipes, and assigns chores through the scheduler - all from a single self-hosted interface accessible on any device.

## Ready To Use

Browse to the instance address and sign in as the administrator to start tracking stock, building shopping lists, storing recipes, and scheduling chores. The database schema is already initialized - no additional setup steps required.

## Use Cases

• Private self-hosted food and household inventory
• Best-before and expiry tracking to reduce food waste
• Shared household shopping lists and meal planning
• Recipe storage and chore, battery, and equipment scheduling
• A self-hosted alternative to commercial home inventory apps

## cloudimg Support

24/7 technical support by email and live chat. Our engineers help with Grocy deployment, upgrades, REST API integration, performance tuning, and storage administration. Critical issues receive a one-hour average response time.

All product and company names are trademarks or registered trademarks of their respective holders. Use of them does not imply any affiliation with or endorsement by them.