GuidesDiscussionSupport us!v2

Locomotive on Heroku in two clicks

If you don't want to read all the manual procedure, click on the button below. It will deploy an instance of Locomotive on Heroku! [![Deploy](https://www.herokucdn.com/deploy/button.svg)](🔗)

To clone your application locally you'll need to follow these steps:

  • `heroku git:clone -a locomotiveapp` (you'll get a warning: You appear to have cloned an empty repository.

  • `git remote add origin https://github.com/locomotivecms/heroku-instant-deploy`

  • `git pull origin master`

  • In order to edit images you'll have to edit you CORS configuration in you S3 bucket so it looks like:


And lastly in the **authorizations** tab allow object read and write to **Any authenticated AWS user** 
## Install the engine locally
Create a new Ruby on Rails app:

Update the Gemfile of the Rails application by adding the locomotivecms gem.

Run the Locomotive installation generator

## Create the Heroku app from your app folder
Heroku toolbelt is required
Visit [https://toolbelt.heroku.com](🔗) to get the installation instructions.

## Setup default Heroku variables
How to get your Heroku API key?
Visit this [link](🔗) and scroll down to the API KEY section.

## Set up a remote Mongodb database
There are currently 2 Heroku add-ons for storing data in MongoDB:
  • [Compose](🔗) (paid plans only)
  • [Mongolab](🔗) (free plan)
Both are really great but since it's free, we'll take Mongolab for the rest of the installation.

## Set up emails
Locomotive needs to send emails and Heroku provides a nice way to send emails for free without configuring a whole mail server on your own. You can find more information [here](🔗).

## Set up Amazon S3
 Heroku doesn't offer file storage that's why you need to register to [Amazon S3](🔗).
Unless you modified your **config/initializers/carrierwave.rb file**, Carrierwave should be set up for Amazon S3 in the production environment.

**Note**: For S3 Bucket Region var, here is address for the correspondance table between your ‘human’ bucket region name, and it’s endpoint [https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region](🔗) 
## Pre-compile your assets
We suggest you to compile your assets locally so that if there is an issue with your assets, you will be able to debug it more easily.
It is very important that you disable the **initialize_on_precompile** option in the **config/application.rb** file of your application:

Then, in your terminal, run the following command:

## Launch it!
In your terminal,

Then, visit your application