DATABASE_URL not documented?

143 views
Skip to first unread message

Sam

unread,
Mar 3, 2022, 8:28:43 AM3/3/22
to Django developers (Contributions to Django itself)
Hi!
While reading Getting Started on Heroku with Python (Provision a database), they are talking about DATABASE_URL as if it was something which is implemented in Django by default.
As far as I know the DATABASE_URL is some kind of alias to access the default of DATABASES (?).

However I don't find any documentation about it.
When I search for site:djangoproject.com "database_url", I mostly find forum posts discussing issues where DATABASE_URL is included.
I found ticket #28236 which suggests integrating dj-database-url into Django, which talks about the "DATABASE_URL environment variable".
The ticket is not solved after five years.

As you see, I am quite confused what DATABASE_URL actually is, since it seems considered common sense (or at least common use).
And therefore I'd suggest to mention it somewhere in the Django Docs.
Does it make sense?

I've expected to find it somewhere in the settings reference.

Kind regards,
Sam

Adam Johnson

unread,
Mar 3, 2022, 8:44:01 AM3/3/22
to Django developers (Contributions to Django itself)
No it's not built in to Django, it's only supported via dj-database-url. The Heroku docs could be improved. They seem to make a passing mention here: https://devcenter.heroku.com/articles/python-concurrency-and-database-connections .

--
You received this message because you are subscribed to the Google Groups "Django developers (Contributions to Django itself)" group.
To unsubscribe from this group and stop receiving emails from it, send an email to django-develop...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/django-developers/3b05c53f-b3a6-4220-aa84-182cd5cea97bn%40googlegroups.com.

Sam

unread,
Mar 3, 2022, 9:56:36 AM3/3/22
to Django developers (Contributions to Django itself)
Thank you for the quick response.
Reply all
Reply to author
Forward
0 new messages