{"id":23069,"library":"django-heroku","title":"django-heroku","description":"A Django library to configure your app for Heroku. Easily sets up database, static files, and other settings based on Heroku environment. Current version 0.3.1 (last released in 2018, maintenance mode).","status":"maintenance","version":"0.3.1","language":"python","source_language":"en","source_url":"https://github.com/heroku/django-heroku","tags":["django","heroku","deployment","static-files","database"],"install":[{"cmd":"pip install django-heroku","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"for DATABASE_URL parsing","package":"dj-database-url","optional":false},{"reason":"PostgreSQL adapter","package":"psycopg2","optional":false},{"reason":"serving static files","package":"whitenoise","optional":false},{"reason":"app configuration helper","package":"django-appconf","optional":false}],"imports":[{"note":"Import the module, then call django_heroku.settings(locals())","wrong":"from django_heroku import ...","symbol":"django_heroku","correct":"import django_heroku"}],"quickstart":{"code":"import django_heroku\nimport django.conf.settings as settings\n# At the bottom of settings.py:\ndjango_heroku.settings(settings)\n","lang":"python","description":"Add at the very bottom of your settings.py file to configure database, static files, and other Heroku-specific settings."},"warnings":[{"fix":"Instead of using django-heroku, manually configure using whitenoise and dj-database-url as described in Heroku's official Django guide.","message":"This library is in maintenance mode. The official approach is to use whitenoise, dj-database-url, and gunicorn manually.","severity":"deprecated","affected_versions":"all"},{"fix":"Ensure the call is the absolute last line in settings.py.","message":"django_heroku.settings(locals()) must be called AFTER all other settings. If called before, it can override your custom settings like STATICFILES_STORAGE.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run pip install django-heroku and ensure your virtualenv is active.","cause":"Missing pip install or virtualenv not activated.","error":"ImportError: No module named 'django_heroku'"},{"fix":"Use django_heroku.settings(locals()) instead of just django_heroku.settings().","cause":"Calling django_heroku.settings() without passing the settings module (usually locals()).","error":"TypeError: settings() missing 1 required positional argument: 'django_settings_module'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}