django-heroku

What it is and what it does

Django-Heroku is a configuration helper for Django applications deployed to Heroku. It automatically configures database connections via DATABASE_URL, serves static files through WhiteNoise, sets up logging, and enables Heroku CI test runners—all with a single call to `django_heroku.settings(locals())` in your Django settings file. You can selectively disable any of these features by passing keyword arguments.

The package depends on dj-database-url, whitenoise, psycopg2, and django. It was designed for Django 2.0 but claims compatibility with older versions. However, the library has been archived and unmaintained since 2018-03-01. This means it will not receive updates for modern Django or Python versions, and Heroku's deployment or CI environment may have evolved in ways that break its assumptions.

Use it for:

• Quickly configure a Django app for Heroku deployment without manually setting DATABASE_URL, ALLOWED_HOSTS, and static file handling.
• Enable Heroku CI test runners by setting TEST_RUNNER to 'django_heroku.HerokuDiscoverRunner'.
• Automatically use a SECRET_KEY environment variable in Django settings if one is set.
• Centralize Heroku-specific configuration in a single settings call rather than scattered environment conditionals.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Configures Django applications for Heroku deployment by automatically setting up databases, static files, logging, and environment variables.

No, unless you are maintaining a legacy Django application already deployed on Heroku and cannot migrate. The package is abandoned (last release 2018-03-01, archived repository), will not receive updates for modern Django or Python versions, and Heroku's own tooling or modern alternatives are likely more reliable. For new projects, configure Heroku settings manually or use actively maintained alternatives.

Install

django-heroku on PyPI

pip install django-heroku

uv add django-heroku

poetry add django-heroku

Installing django-heroku

Before you install

Low install friction with a small, stable dependency chain (dj-database-url, whitenoise, psycopg2, django). However, the package is archived and abandoned—last release was 2018-03-01 with no updates since. Use only if your Heroku setup matches the library's assumptions.

License in practice

MIT license permits unrestricted use, modification, and distribution. No licensing barriers to adoption.

Quickstart

pip install django-heroku

# In Django settings.py, at the bottom:
import django_heroku
django_heroku.settings(locals())

Requires Django and Python 3; the package is unmaintained and may not work with modern Django or Python versions beyond those listed in its classifiers.

Verify before relying

• Compatibility with Django versions released after 2018-03-01 and current Python 3.x releases
• Whether Heroku's deployment environment or CI system has changed in ways that break this library's assumptions
• Active alternatives or whether Heroku's own tooling has superseded this library's functionality

Package facts

Evidence: django_heroku-0.3.1-py2.py3-none-any.whl

Tags

More Application Frameworks packages