Fixed #135 -- Added 'Multiple Django installations on the same Apache' to docs/mod_python.txt

git-svn-id: http://code.djangoproject.com/svn/django/trunk@275 bcc190cf-cafb-0310-a4f2-bffc1f526a37

1 files changed, 25 insertions, 0 deletions

diff --git a/docs/modpython.txt b/docs/modpython.txt
index 371c207af0..dc5364a4db 100644
--- a/docs/modpython.txt
+++ b/docs/modpython.txt
@@ -63,6 +63,31 @@ Here's a template for an admin configuration::
 
 The only thing different here is the ``DJANGO_SETTINGS_MODULE``.
 
+Multiple Django installations on the same Apache
+================================================
+
+It's entirely possible to run multiple Django installations on the same Apache
+instance. Just use ``VirtualHost`` for that, like so::
+
+    NameVirtualHost *
+
+    <VirtualHost *>
+        ServerName www.example.com
+        # ...
+        SetEnv DJANGO_SETTINGS_MODULE myproject.settings.main
+    </VirtualHost>
+
+    <VirtualHost *>
+        ServerName admin.example.com
+        # ...
+        SetEnv DJANGO_SETTINGS_MODULE myproject.settings.admin
+    </VirtualHost>
+
+Don't put two Django installations within the same ``VirtualHost``. Due to the
+way mod_python caches code in memory, your two Django installations will
+conflict. If you can think of a way to solve this problem, please file a ticket
+in our ticket system.
+
 Running a development server with mod_python
 ============================================