---
id: django-heroku
version: "0.3.1"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# django-heroku — This is a Django library for Heroku apps.

License: permissive · Maintenance: abandoned · Downloads: 89.0K/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: abandoned
- Downloads: 89.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

heroku django deployment, django heroku configuration, heroku static files whitenoise, django database url heroku, heroku ci test runner django, heroku-deployment, abandoned

[View on SkillFed](https://skillfed.io/packages/django-heroku) · [View on PyPI](https://pypi.org/project/django-heroku/)