diff options
| author | Tim Graham <timograham@gmail.com> | 2013-06-09 15:05:15 -0400 |
|---|---|---|
| committer | Tim Graham <timograham@gmail.com> | 2013-06-09 15:05:15 -0400 |
| commit | 4e94c84e50b960405d5708d8d9528c44c7dabe83 (patch) | |
| tree | 51139dcd674f66ddff3a9c8ef52e21b5ebd12f06 | |
| parent | 175a102ddceae2ebd1a4e03916a23adafc35bda5 (diff) | |
Fixed #19875 - Added warnings regarding DEBUG=False and empty ALLOWED_HOSTS
| -rw-r--r-- | docs/intro/tutorial03.txt | 7 | ||||
| -rw-r--r-- | docs/ref/settings.txt | 4 | ||||
| -rw-r--r-- | docs/topics/settings.txt | 5 |
3 files changed, 16 insertions, 0 deletions
diff --git a/docs/intro/tutorial03.txt b/docs/intro/tutorial03.txt index 120369172e..6193ec45f7 100644 --- a/docs/intro/tutorial03.txt +++ b/docs/intro/tutorial03.txt @@ -473,6 +473,13 @@ template for all 404 errors when :setting:`DEBUG` is set to ``False`` (in your settings module). If you do create the template, add at least some dummy content like "Page not found". +.. warning:: + + If :setting:`DEBUG` is set to ``False``, all responses will be + "Bad Request (400)" unless you specify the proper :setting:`ALLOWED_HOSTS` + as well (something like ``['localhost', '127.0.0.1']`` for + local development). + A couple more things to note about 404 views: * If :setting:`DEBUG` is set to ``True`` (in your settings module) then your diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt index ef52d3170c..897af275a0 100644 --- a/docs/ref/settings.txt +++ b/docs/ref/settings.txt @@ -852,6 +852,10 @@ It is also important to remember that when running with :setting:`DEBUG` turned on, Django will remember every SQL query it executes. This is useful when you're debugging, but it'll rapidly consume memory on a production server. +Finally, if :setting:`DEBUG` is ``False``, you also need to properly set +the :setting:`ALLOWED_HOSTS` setting. Failing to do so will result in all +requests being returned as "Bad Request (400)". + .. _django/views/debug.py: https://github.com/django/django/blob/master/django/views/debug.py .. setting:: DEBUG_PROPAGATE_EXCEPTIONS diff --git a/docs/topics/settings.txt b/docs/topics/settings.txt index fa26297988..1cfcd262cd 100644 --- a/docs/topics/settings.txt +++ b/docs/topics/settings.txt @@ -17,6 +17,11 @@ Here are a couple of example settings:: DEFAULT_FROM_EMAIL = 'webmaster@example.com' TEMPLATE_DIRS = ('/home/templates/mike', '/home/templates/john') +.. note:: + + If you set :setting:`DEBUG` to ``False``, you also need to properly set + the :setting:`ALLOWED_HOSTS` setting. + Because a settings file is a Python module, the following apply: * It doesn't allow for Python syntax errors. |