Deploy Grocy
Groceries and household management: stock, shopping lists, chores
Just deployed
/config
Deploy and Host Grocy on Railway
Grocy is a self-hosted, open-source (MIT) web app for groceries and household management. It tracks what you have in stock and when it expires, builds shopping lists, and handles recipes, meal plans, chores, tasks and batteries. Every screen also has a REST API, and a barcode scanner works from a phone.
About Hosting Grocy
Grocy is a PHP application with an SQLite database, so one service with a persistent volume is all it needs. This template builds the LinuxServer.io Grocy 4.7.1 image, pinned by digest, from a public GitHub repo, and keeps the database, settings and uploaded pictures on a volume at /config. On the first boot it creates the database and the first user from generated credentials, so Grocy's default admin / admin login never exists on your public URL. nginx listens on Railway's port, and a /healthz route tells Railway when the database is ready. The deploy form asks for nothing.
Common Use Cases
- Track pantry, fridge and freezer stock with best-before dates, and use up food before it spoils
- Keep a shared household shopping list that fills itself from minimum stock amounts and recipes
- Plan meals, schedule recurring chores and tasks, and track battery changes for home devices
Dependencies for Grocy Hosting
- One Railway service built from aalfath/grocy-railway-template (nginx, PHP-FPM and Grocy)
- One Railway volume at
/config(SQLite database, settings, pictures)
Deployment Dependencies
- Grocy: grocy.info, source and releases
- Image: linuxserver/grocy
v4.7.1-ls352, pinned by digest - Settings reference: config-dist.php
Implementation Details
After the deploy finishes, open the service's public domain and sign in as admin with the password in the service's Variables tab (GROCY_ADMIN_PASSWORD). You can change it in Grocy under Manage users: later deploys don't overwrite it. Then set your currency and language in Grocy's settings, or add variables named after any Grocy setting, for example GROCY_CURRENCY=EUR, GROCY_DEFAULT_LOCALE=de or GROCY_FEATURE_FLAG_CHORES=false. TZ sets the time zone used for due dates.
Updates: the template repo pins the Grocy image by version and digest. When a new Grocy release is merged there, Railway shows an "update available" notice on your project. Read the repo's CHANGELOG.md first; Grocy migrates its database on the next boot and your volume keeps the data. For a backup, copy /config/data/grocy.db.
Why Deploy Grocy on Railway?
Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.
By deploying Grocy on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.
Template Content
