Deploy Spree Commerce Platform

Spree headless commerce with a Solid Queue worker, PostgreSQL and a bucket

Deploy Spree Commerce Platform

Commerce

Just deployed

Spree Worker

spree/spree:6.0.5

Just deployed

Spree Uploads

Bucket

Just deployed

Data

Spree PostgreSQL

postgres:18.7-alpine

Just deployed

/var/lib/postgresql

Deploy and Host Spree Commerce on Railway

Spree Commerce is an open-source headless ecommerce platform. It gives you REST Store and Admin APIs, a React admin dashboard, a marketplace Seller Panel, promotions, gift cards, multi-currency markets, B2B price lists and webhooks, so you can run a store, a wholesale portal or a multi-vendor marketplace on your own infrastructure.

About Hosting Spree Commerce

The template runs Spree 6.0.5 from the official image, pinned by digest, as two services: a public web service with the APIs, the admin dashboard at /dashboard and the job dashboard at /jobs, and a private worker that processes images, emails, webhooks, imports and exports. PostgreSQL 18 holds the store, the job queue and the cache on a private volume, and uploaded product images and exports live in a private Railway Bucket shared by both services, so files survive every redeploy. Set ADMIN_EMAIL before you deploy: the first admin account is created with that email and a generated password, which you copy from the Spree service's variables, and Spree's first-run setup is closed from the first request.

Why Deploy Spree Commerce on Railway

Railway provides the HTTPS domain, private networking between Spree, its worker and PostgreSQL, a persistent volume, object storage, generated secrets and health-checked deploys. Migrations run on every deploy before the web service listens, the worker waits for them, and customer addresses are read correctly behind Railway's proxy, so per-visitor rate limits work.

Common Use Cases

  • Run the backend for a headless store built with the Spree Next.js storefront, a mobile app or your own frontend
  • Build a multi-vendor marketplace or a B2B wholesale portal with price lists and customer groups
  • Move a catalog, orders and customers off a hosted commerce platform to infrastructure you own

Dependencies for Spree Commerce Hosting

The deployment uses Spree Commerce (spreecommerce.org, documentation), PostgreSQL and a Railway Bucket.

Deployment Dependencies

  • Spree 6.0.5 web service and Solid Queue worker, from ghcr.io/spree/spree
  • PostgreSQL 18 with a 5 GB volume
  • A private Railway Bucket for uploads, exports and imports
  • Optional: a Stripe account for card payments, an SMTP provider for order and account emails, and the Spree Next.js storefront as a separate service

Template Content

Spree PostgreSQL

postgres:18.7-alpine

Spree Uploads

Bucket

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