These docs are a work-in-progress and are currently undergoing a major rewrite!

forge-heroku

Deploy a Django project to Heroku with minimal configuration.

This package is specifically designed to work with the Forge Quickstart and the Forge Heroku Buildpack.

Installation outside of the Forge Quickstart might work, but is not documented or necessarily recommended.

Default Procfile

When you use the Forge buildpack, Heroku will automatically set up a Procfile for you. Here's what it does:

web: forge serve
release: forge pre-deploy

If you need to customize your Procfile, simply add one to your repo!

Deploy checks

In the Heroku "release" phase we run manage.py check --deploy --fail-level WARNING as part of forge pre-deploy.

This runs a number of Django system checks (many related to the settings above) and will prevent deploying your app if any checks fail. You can also create your own checks that will run during this process.

Migrations

The forge pre-deploy will also run manage.py migrate to ensure that your database is up to date.