How do I deploy Grocy on Railway?

You can deploy Grocy on Railway by clicking the "Deploy Now" button on this page. Railway will automatically set up all the necessary services and configurations for you.

What are the system requirements?

Railway handles all the infrastructure requirements. You only need a web browser to deploy and manage your application.

Is this template free to use?

Yes, this template is free to use within your existing Railway account.

Can I customize this template?

Yes, you can fully customize this template. After deployment, you will have full control of what you've deployed in your Railway project.

How do I get support for this template?

You can get support through our community forum: grocy-898675d8, or join our Discord community for more assistance.

Deploy and Host Grocy on Railway

Grocy is a self-hosted web application designed to manage your household groceries and inventory. It acts as a smart pantry organizer, helping you track stock levels, locations, and expiration dates. By integrating recipe management and shopping lists, Grocy helps streamline your shopping trips and reduce food waste while keeping your data private.

About Hosting Grocy

Hosting Grocy typically involves managing a web server stack (Nginx/PHP) and a database. This template utilizes the LinuxServer.io Docker image, which bundles these components into a single, efficient container. The primary requirement for hosting is a persistent volume to store your SQLite database, product images, and configuration files, ensuring data is retained between deployments.

This specific template includes a custom patch to handle DNS resolution. It automatically configures Nginx to work seamlessly with Railway's internal network environment, ensuring the service starts reliably without manual configuration edits.

Common Use Cases

Household Inventory Tracking: Keep a precise count of items in your pantry, fridge, and freezer to avoid over-buying or running out of essentials.
Meal Planning & Waste Reduction: Track expiration dates to prioritize ingredients before they spoil and plan meals based on what you currently have in stock.
Smart Shopping Lists: Automatically generate shopping lists based on your favorite recipes and current inventory levels.

Dependencies for Grocy Hosting

Docker Engine: The application runs as a containerized service.
Persistent Storage: A volume mounted to /config is required to persist the database and application settings.

Deployment Dependencies

Implementation Details

IPv6 Resolver Patch This template uses a custom Dockerfile to fix a known Nginx compatibility issue on Railway. It injects a script (/custom-cont-init.d/99-fix-resolver) that forces Nginx to use a standard IPv4 DNS resolver, preventing crashes caused by internal IPv6 formatting.

Default Credentials Once deployed, log in with the default credentials. Change these immediately in the settings.

Username: admin
Password: admin

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.