2.0 to 2.1
This guide covers upgrading a 2.0.x Spree store, to a 2.1.x store.

Overview

This guide has been written from the perspective of a blank Spree 2.0.x store with no extensions.
If you have extensions that your store depends on, you will need to manually verify that each of those extensions works within your 2.1.x store once this upgrade is complete. Typically, extensions that are compatible with this version of Spree will have a 2-1-stable branch.
This is the first Spree release that supports Rails 4 exclusively. Spree releases after this point will continue to support Rails 4 only.

Upgrade Rails

For this Spree release, you will need to upgrade your Rails version to at least 4.0.0.
It is recommended to read through the Upgrading Ruby on Rails guide to learn what needs to be done for your application to migrate to Rails 4.
1
gem 'rails', '~> 4.0.0'```
2
3
## Upgrade Spree
4
5
For best results, use the 2-1-stable branch from GitHub:
6
7
```ruby
8
gem 'spree', github: 'spree/spree', branch: '2-1-stable'```
9
10
Run `bundle update spree`.
11
12
## Copy and run migrations
13
14
Copy over the migrations from Spree (and any other engine) and run them using
15
these commands:
16
17
rake railties:install:migrations
18
rake db:migrate
19
20
## Read the release notes
21
22
For information about changes contained with this release, please read the [2.1.0 Release Notes](http://guides.spreecommerce.org/release_notes/spree_2_1_0.html).
23
24
## Verify that everything is OK
25
26
Click around in your store and make sure it's performing as normal. Fix any deprecation warnings you see.
Copied!
Last modified 2mo ago
Copy link