Grocy

Grocy is a self-hosted ERP system for your kitchen and household. It runs on PHP with an SQLite backend and provides a responsive web interface for managing everyday logistics at home.

What You Can Do After Deployment

• Track stock — scan barcodes or add products manually, get expiry alerts and automatic shopping list entries when running low
• Shopping lists — maintain multiple lists, share with family, and check items off from any device
• Meal planning — plan meals for the week and consume ingredients directly from stock
• Recipes — store recipes with ingredient lists that link to your stock, auto-calculate costs
• Chores tracking — schedule recurring chores, assign to household members, and track completion
• Battery tracking — log battery replacements for devices and get reminders when they are due
• Custom fields & userfields — extend any entity with your own data fields

Default Credentials

Username	Password
admin	admin

Change the password immediately after your first login via Settings > User management.

Environment Variables

Variable	Default	Description
PUID	1000	User ID for file permissions
PGID	1000	Group ID for file permissions
TZ	UTC	Timezone for expiry dates and scheduled tasks

License

Grocy is licensed under MIT.