Skip to content

Upgrading from Spree

Jump to bottom
John Hawthorn edited this page Jul 6, 2017 · 12 revisions

From Spree 2.0 to 2.1

Spree 2.0 was the last version on rails 3. The 2.1 upgrade includes rails 4 and strong_params, which can require many changes to any custom code. It's recommended to upgrade to Spree 2.1 and then 2.2 before upgrading to solidus.

From Spree 2.1 to 2.2

Spree 2.2 made some major changes to the way adjustments are handled. Taxes and other adjustments are now best handled per-item (line_item/shipment) instead of on the order. This can be a difficult change so we recommend upgrading to Spree 2.2 before upgrading to Solidus.

From Spree 2.2, 2.3, or 2.4

We intend Spree 2.2, 2.3, and 2.4 to be upgradable directly onto Solidus. We've improved the migrations and added fixed a few issues which should make it an easier upgrade.

You may want to start with Solidus 1.4, the last version using Rails 4.2. Solidus 2.0 is the first version using Rails 5.

For more details please read

From Spree 3.0

Solidus is a fork of Spree 2.4, and has diverged from Spree 3.0, making this a little more difficult than other upgrades. For 3.0 users looking to upgrade we recommend upgrading to the current Solidus 1.1, which includes updated migrations to support data from spree 3.0.

One major difference is that Solidus doesn't include Spree 3.0's change to a bootstrap frontend and backend.

You may want to start with Solidus 1.4, the last version using Rails 4.2. Solidus 2.0 is the first version using Rails 5.

Clone this wiki locally