Upgrading Spree

Every Spree upgrade is the same three stages:

Bump the gems — bundle update the spree* gems.
Migrate the schema — copy new migrations out of the gems (spree:install:migrations) and run db:migrate.
Backfill data — rake spree:upgrade runs the version-specific data tasks listed in the upgrade manifests shipped inside spree_core.

Then a fourth, manual stage: review the upgrade guide for your hop (behavior changes, config moves, code that needs editing). The rake-runnable part never covers everything.

Going from 5.x to 6.0? That's a major, breaking hop with preconditions (you must be on 5.6 first, Rails 8.1, Gemfile swaps, roles-as-data). Read the spree-upgrade-5-to-6 skill before starting.

Pick your flavor

Project	How you run it
`create-spree-app` (Docker + `@spree/cli`, Rails app in `server/` — older projects: `backend/`)	`spree upgrade`
Classic Rails app with Spree gems at the repo root (no Docker/CLI)	the native commands below
Production (either flavor)	your deploy pipeline + `bundle exec rake spree:upgrade`