> ## Documentation Index
> Fetch the complete documentation index at: https://spreecommerce.org/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 2.3 to 2.4

> This guide covers upgrading a 2.3 Spree store, to a 2.4 store.

This guide has been written from the perspective of a blank Spree 2.3 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.4 store once this upgrade is complete. Typically, extensions that are compatible with this version of Spree will have a 2-4-stable branch.

## Upgrade Rails

For this Spree release, you will need to upgrade your Rails version to at least 4.1.8.

```ruby theme={"theme":"night-owl"}
gem 'rails', '~> 4.1.8'
```

## Upgrade Spree

```ruby theme={"theme":"night-owl"}
gem 'spree', '~> 2.4'
```

Run `bundle update spree`.

## Copy and run migrations

Copy over the migrations from Spree (and any other engine) and run them using
these commands:

```bash theme={"theme":"night-owl"}
rake railties:install:migrations
```

```bash theme={"theme":"night-owl"}
rake db:migrate
```

## Read the release notes

For information about changes contained within this release, please read the [2.4.0 Release Notes](https://github.com/spree/spree/releases/tag/v2.4.0).