Deploy to Heroku

Codeship makes makes it easy to deploy your application to Heroku using Codeship’s integrated deployment pipelines.

  • include a table of contents

Setup Heroku Deployment

Step 1 - Navigate to Deployment Configuration

Navigate to your project’s deployment configuration page by selecting Project Settings > Deployment on the top right side of the page.

Project Settings Deployment

Step 2 - Add New Deployment Pipeline

Edit an existing deployment pipeline or create a new deployment pipeline by selecting + Add new deployment pipeline. Create the deployment pipeline to match the exact name of your deployment branch or a wildcard branch.

Create branch deploy

Step 3 - Heroku

Select Heroku

Select Heroku

Step 4 - Deployment Configuration

Configure Heroku

Application URL

Insert the name of the Heroku application you want the pipeline to deploy to.

Heroku API Key

In order for you to deploy your app using Codeship, you need to provide the Heroku API key from your Heroku account. You can access your Heroku API key here.


Heroku Success

You have now successfully setup deployment to Heroku. Go ahead and push a commit to your configured deploy branch.

Additonal Configuration Settings (optional)

You can configure additional settings to your Heroku deployment by selecting More Options:

Select Heroku Deploy Options

Heroku Deploy Options


After each deployment, we check your application to make sure that it is up. We will either call the default * URL or the URL you specified here.

If this URL requires basic auth please enter: http://YOUR_USERNAME:YOUR_PASSWORD@YOUR_URL


This takes a different Heroku app and will restore the database of the current Heroku application you are deploying to with the main database from the Heroku application posted here.

Backup Database

Backup your database before you deploy. See Heroku’s Creating a Backup page for more information.

Force Push

This causes git to disable some checks and can cause the remote repository to lose commits. Use this option with care.

See git push -f for more info.

Run Migrations (Ruby on Rails only)

You can specify to run the migration during the Heroku deployment. If you want to run your migration after the deployment, you can add a custom script after the Heroku deployment and run the migration.


heroku run --exit-code --app ${HEROKU_APPLICATION_NAME} -- bundle exec rake db:migrate

Heroku Migration After Deploy

Check app URL

This will enable your build to check the URL of your application to make sure that it is up.


Need More Help?

Get in touch if you need more help, or post on Stack Overflow using the tag #Codeship.

  • Ask The Helpdesk A Question
  • Code Examples And Sample Projects
    • Was This Article Helpful?