
Deploy Spree Commerce Platform
Spree headless commerce with a Solid Queue worker, PostgreSQL and a bucket
Commerce
Spree
Just deployed
Spree Worker
Just deployed
Spree Uploads
Bucket
Just deployed
Data
Spree PostgreSQL
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
ADMIN_EMAIL
Email address of the first admin account, created on the first deploy.
Spree Worker
ghcr.io/spree/spree:6.0.5Spree PostgreSQL
postgres:18.7-alpineSpree Uploads
Bucket
