Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Spree extension for hosting Spree 1.0.x on Heroku. From 1.1.x onward, you do not need this extension as Spree supports AWS-S3 out of the box. However, if you prefer setting up with Heroku with config vars, this extension is still relevant.
Pull request Compare This branch is 32 commits ahead of RSpace:master.
Latest commit 3a3aa21 @joneslee85 Merge pull request #1 from jnettome/master
URL issues in S3
Failed to load latest commit information.
app/models Small code change to make S3 work on development too.
config Added support to change url parameter for S3 by s3.yml file. With exa…
lib Use official aws-sdk gem
.gems Add aws-s3 gem dependency
.gitignore Added .gitignore
LICENSE Refactor reloaded Update
Rakefile Ported to Spree 1.0
Versionfile Branching 1-0-stable
spree_heroku.gemspec aws-sdk version must be specific

Spree Heroku

This is an extension for Spree, allowing the e-commerce system to run on Heroku -

The major constraint on Heroku is that we can't write files to disk, so this extension disables all disk caching, fixes a few issues and changes Spree to store on Amazon S3.


A Heroku account and an Amazon S3 account with a bucket.

Installation and configuration

Add this to your project Gemfile:

gem 'spree_heroku', :git => 'git://'

Install the new gems with bundler:

$ bundle install

Specify the S3 credentials by two ways:

Create Heroku config var for specific environment

$ heroku config:add S3_KEY='your_access_key'
$ heroku config:add S3_SECRET='secret_access_key'
$ heroku config:add S3_BUCKET='your_app_bucket'


Create under RAILS_ROOT/config/s3.yml

  bucket: your_app_dev
  access_key_id: your_access_key
  secret_access_key: secret_access_key
  url: domain_url_or_path

  bucket: your_app_test
  access_key_id: your_access_key
  secret_access_key: secret_access_key
  url: domain_url_or_path

  bucket: your_app_prod
  access_key_id: your_access_key
  secret_access_key: secret_access_key
  url: domain_url_or_path

Create a Heroku application and deploy it:

$ git init
$ git add .
$ git commit -m 'Initial create'
$ heroku create
$ git push heroku master

Bootstrap the database locally (not possible in Heroku, because the rake task attempts to copy files), and transfer it to Heroku:

$ bundle exec rake db:bootstrap
$ heroku db:push

Please note that if you choose to load sample data, images will be missing for all products. Spree's bootstrap task copies the images locally, but it doesn't put them on S3, where this extension configures Spree to look for images.

That's it - you're done! :)

Explanation about url variable

See the url variable in

url in s3.yml can be ":s3_domain_url" or ":s3_path_url" (default). STRING.


This extension has been tested with Spree 1.0 and Rails 3.1.3. If you have problems using the extension with a newer version of Spree, it could be due to Spree's gem dependencies having changed.

Copyright (c) 2012 Trung Lê, released under the New BSD License

Something went wrong with that request. Please try again.