Spree Commerce
Spree Commerce is an open-source, headless e-commerce platform built on Ruby on Rails that lets self-hosters build B2B, marketplace, and enterprise online…
Platform availability
Available on 1 of 10 platforms
- Unraid (not listed)
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
78/100 Good
- Maintained
- 100last commit 1 day ago
- Popular
- 8415,848 GitHub stars
- Easy to install
- 251 install platform, install notes
- Light to run
- No data
Based on 3 of 4 factors.
Availability: platform listings confirmed today
- GitHub stars
- 15,848
- Open issues
- 226
- Last commit
- 2026-11-20
- Latest release
- v6.0.5
- License
- BSD-3-Clause
- Activity
- declining
Checked today - source: GitHub (spree/spree)
Resources & Compatibility
Requirements not published yet.
Checked today - source: Docker Hub image tags and published docs
First-install notes
- Run the first-time setup command In your Spree project folder, run spree init so it starts the Docker services, seeds the database, and creates an API key. Without this, the app has no database or API key and won't work for stores or admins. source
- Create the storefront environment file If you added a storefront app, copy .env.local.example to .env.local, then add your Spree API key there so the store can talk to the backend. Without this, the storefront cannot find products or settings. source
- Start the storefront separately Open a second terminal, go to my-store/apps/storefront, and run pnpm dev to start the local storefront website at http://localhost:3001. If you skip this, the backend may be running but there is no public store page to open. source
Fetched today - each note links to its source
Variants
Alternatives (9)
- Etsy - Marketplace for handmade, vintage, and unique items offering direct sales from independent creators worldwide, including crafts, art, and d…
- LiteCart - Lightning fast e-commerce platform built in PHP.
- Medusa - Medusa is an automatic video library manager for TV shows.
- OpenCart - OpenCart is a free open-source PHP e-commerce platform that lets merchants, homelab admins, and store owners create and manage online store…
- Payhip - Platform simplifies sales of digital products like ebooks, courses, and coaching services.
- PrestaShop - PrestaShop is an open-source e-commerce free software powering nearly 200,000 online stores.
- Sell.app - Sell.app is the easiest way to sell digital products online.
- Shopify - A cloud-based e-commerce platform offering customizable online store creation, channel sales, inventory management, secure payments, and sh…
- WooCommerce - Open-source ecommerce platform supporting physical and digital sales, customizable storefronts, booking and subscription features, and wide…
Checked today - source: AlternativeTo
Common questions
How do I initialize a local Spree backend with a database and API key?
Run spree init in your Spree project folder to start the Docker services, seed the database, and create an API key. If you skip this, the app has no database or API key for stores or admins.
How do I point the Next.js storefront at the Spree backend?
Copy .env.local.example to .env.local and add your Spree API key there so the store can talk to the backend. Without this, the storefront cannot find products or settings.
Do I need to start the storefront separately during local development?
Yes, open a second terminal, go to my-store/apps/storefront, and run pnpm dev to start the local storefront at localhost:3001. If you skip this, the backend may be running but there is no public store page to open.
Can I build a mobile app that uses the same Spree backend?
Yes, Spree provides REST APIs that allow mobile app developers to build commerce experiences against a shared backend.
Can I manage the store with an AI agent or MCP interface?
Spree ships with an MCP server that can manage the store via chat. It also includes agent skills for coding agents.
Answers sourced from en.wikipedia.org, github.com, github.com, github.com, github.com
Community
- Spree: Open-source eCommerce platform Built using Ruby on Rails (forum)
- Webinar on Headless Commerce Using Vue Storefront and Spree Commerce (forum)
- Webinar on building storefronts with Next.js and open-source Spree Commerce (forum)
- Show HN: A custom natural supplements e-commerce store built with SpreeCommerce (forum)
- New Spree Commerce roadmap announcement (forum)
- Spree: complete Open Source eCommerce solution for Ruby on Rails (forum)
Collected today - public community threads