Estimated Reading Time: 4 mins
Codeship makes it easy to deploy your application to Heroku using Codeship’s integrated deployment pipelines.
Navigate to your project’s deployment configuration page by selecting Project Settings > Deploy on the top right side of the page.
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.
Get the public SSH key for your project under Project Settings > General and add it to Heroku. If you miss this step you may see an error like this during the
git push step of the deploy:
Permission denied (publickey). fatal: Could not read from remote repository. Please make sure you have the correct access rights and the repository exists.
Insert the name of the Heroku application you want the pipeline to deploy to.
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.
You have now successfully setup deployment to Heroku. Go ahead and push a commit to your configured deploy branch.
You can configure additional settings to your Heroku deployment by selecting More Options:
After each deployment, we check your application to make sure that it is up. We will either call the default
*.herokuapp.com URL or the URL you specified here.
If this URL requires basic auth please enter:
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 your database before you deploy. See Heroku’s Creating a Backup page for more information.
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.
You can specify a command to run post-deployment. The dynos will be restarted after running. This can be useful for running migrations or other commands that need to be run on each deploy.
This will enable your build to check the URL of your application to make sure that it is up.
After each deployment we check if your app is up. Therefore we call (
wget) either the default
*.herokuapps.com URL or the URL you specified here.
If the build fails during
check_url YOUR_URL it’s usually because your application does not respond with a HTTP/2xx status code at the URL you provided (or the default URL for the deployment if you didn’t provide any).
To solve this, you can:
Respond with a HTTP/200 status code at the root of your application.
Configure a URL that will respond with such an status code in the advanced deployment configuration.
Enter a generic URL(e.g.
http://google.com) in the deployment configuration if you want to disable the check entirely.
We also have a couple of code examples and sample projects available, that make it easier to get started with Codeship.