Heroku extension for LocomotiveCMS
Ruby JavaScript
Failed to load latest commit information.
script initialize Feb 17, 2012
spec bump version to 0.1.0 + upgrade the doc Jun 17, 2013
.gitignore do not include log files Feb 18, 2012
.rspec initialize Feb 17, 2012
Gemfile all the tests pass Jun 17, 2013
Gemfile.lock bump version to 0.1.0 + upgrade the doc Jun 17, 2013
MIT-LICENSE change the way of passing params to the Heroku extension Feb 18, 2012
README.textile bump version to 0.1.0 + upgrade the doc Jun 17, 2013
Rakefile all tests pass Feb 18, 2012
locomotive_heroku.gemspec Update locomotive_heroku.gemspec Jun 17, 2013


Heroku extension for LocomotiveCMS

This extension allows LocomotiveCMS to run on heroku


  • Heroku gem
  • Heroku app
  • Heroku API key
  • LocomotiveCMS engine


Inside your LocomotiveCMS application, open your Gemfile file and insert the following line after the one referencing LocomotiveCMS

gem 'locomotive-heroku', :require => 'locomotive/heroku'


Then, you have to let Heroku know about your API key and your application name
Modify your Locomotive config file (config/initializers/locomotive.rb)

config.hosting = { :target => :heroku, :api_key => '<YOUR HEROKU API KEY>', :app_name => '<MY HEROKU APP NAME>' }

Storage: Amazon S3

Because Heroku disables writing on their disk, we have to use Amazon S3 or any storage providers as long as they are supported by Carrierwave. In the following example, we will use Amazon S3 which is by far the most known/used.

Open your terminal and at the root of your application on your machine,

heroku config:add S3_KEY_ID=<your s3 key id>
heroku config:add S3_SECRET_KEY=<your s3 secret key>
heroku config:add S3_BUCKET=<your s3 bucket name>

Note: If you plan to use another storage provider, do not forget to modify the config/carrierwave.rb file accordingly.


Feel free to contact me at didier at nocoffee dot fr.

Copyright © 2013 NoCoffee, released under the MIT license