Browse files

Fixed #18518 -- Add warning re mod_wsgi and environ handling.

  • Loading branch information...
1 parent e44bedd commit 751a7d0c32746dc6774f1b561db523b25365148a @carljm carljm committed Sep 28, 2012
Showing with 15 additions and 0 deletions.
  1. +4 −0 django/conf/project_template/project_name/
  2. +11 −0 docs/howto/deployment/wsgi/modwsgi.txt
@@ -15,6 +15,10 @@
import os
+# We defer to a DJANGO_SETTINGS_MODULE already in the environment. This breaks
+# if running multiple sites in the same mod_wsgi process. To fix this, use
+# mod_wsgi daemon mode with each site in its own daemon process, or use
+# os.environ["DJANGO_SETTINGS_MODULE"] = "{{ project_name }}.settings"
os.environ.setdefault("DJANGO_SETTINGS_MODULE", "{{ project_name }}.settings")
# This application object is used by any WSGI server configured to use this
@@ -56,6 +56,15 @@ for you; otherwise, you'll need to create it. See the :doc:`WSGI overview
documentation</howto/deployment/wsgi/index>` for the default contents you
should put in this file, and what else you can add to it.
+.. warning::
+ If multiple Django sites are run in a single mod_wsgi process, all of them
+ will use the settings of whichever one happens to run first. This can be
+ solved with a minor edit to ```` (see comment in the file for
+ details), or by :ref:`using mod_wsgi daemon mode<daemon-mode>` and ensuring
+ that each site runs in its own daemon process.
Using a virtualenv
@@ -71,6 +80,8 @@ Make sure you give the correct path to your virtualenv, and replace
.. _virtualenv:
+.. _daemon-mode:
Using mod_wsgi daemon mode

0 comments on commit 751a7d0

Please sign in to comment.