Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

heroku plugin to copy s3 assets to local development

branch: master

Fetching latest commit…


Cannot retrieve the latest commit at this time

Octocat-spinner-32 lib
Octocat-spinner-32 MIT-LICENSE
Octocat-spinner-32 README.rdoc
Octocat-spinner-32 VERSION
Octocat-spinner-32 init.rb

Heroku s3assets

Heroku Plugin that provides the ability to download all production s3 assets to your local development app. A common scenario in development is to copy production data to development via the use of heroku db:pull. With this plugin one can also copy production assets stored on s3.


  1. Mac OS X, Linux, or UNIX.

  2. A Heroku account.

  3. aws/s3 gem needs to be installed. gem install aws-s3

  4. progress_bar gem needs to be installed. gem install progress_bar


To install:

$ heroku plugins:install


This plugin assumes that your production Heroku app is storing assets on Amazon s3 and that your Heroku app has the following three config vars properly defined: S3_BUCKET, S3_KEY and S3_SECRET ( see for more info). If any of the S3 config vars are not set you can specify them using command line options.

$ heroku s3assets:pull [--bucket <bucket>] [--key <s3key> ] [--secret <s3secret> ][--output <path>]

To copy all s3 assets to default public/system folder

$ heroku s3assets:pull

To copy all s3 assets to public/assets folder

$ heroku s3assets:pull --output public/assets

If you do not have a S3_BUCKET config var set you can specify a specific bucket as follows:

$ heroku s3assets:pull --bucket mybucket


Please see MIT-LICENSE for more details.


Copyright © 2010 Rounders Consulting Inc.

Something went wrong with that request. Please try again.