Deploy Grocy

Groceries and household management: stock, shopping lists, chores

Deploy Grocy

/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

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

More templates in this category

View Template
Rocky Linux
Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀

codestorm
51
View Template
Foundry Virtual Tabletop
Self-hosted virtual tabletop for role-playing games (license required)

Lucas
71
View Template
NEW
Double Commander in your browser
The Double Commander file manager in the cloud, from any device

Nermin Sabanovic
0