Django/Apache - Revision history

Johnno: /* Example Apache VHost configuration */ Apache 2.4

2014-10-24T02:39:10Z

Example Apache VHost configuration: Apache 2.4

Johnno at 02:38, 24 October 2014

2014-10-24T02:38:38Z

Johnno: mod_python considered harmful.

2014-10-24T02:37:20Z

mod_python considered harmful.

Johnno at 21:54, 29 January 2009

2009-01-29T21:54:41Z

Johnno: New page: Setting up Django on Apache 2 is relatively straightforward, but with a few kinks noted herewith. == Django Requirements == * Python >= 2.4 * Apache 2 * mod_python - Apache module to supp...

2009-01-29T21:40:19Z

New page: Setting up Django on Apache 2 is relatively straightforward, but with a few kinks noted herewith. == Django Requirements == * Python >= 2.4 * Apache 2 * mod_python - Apache module to supp...

New page

Setting up Django on Apache 2 is relatively straightforward, but with a few kinks noted herewith.

== Django Requirements ==
* Python >= 2.4
* Apache 2
* mod_python - Apache module to support Python code, similar to mod_perl
* PostgreSQL >= 8.0
* python-psycopg2 - PostgreSQL client library for Python
* python-imaging - Python Imaging library
* memcached and python-memcache ''(optional but reccommended)''
== Preparation ==

Django can be installed from the Debian packaged version, or fetched with SVN or with git from the [http://git.catalyst.net.nz/gitweb?p=django.git Catalyst Django git mirror]. and mod_python and psycopg2 can be simply installed using apt-get:

apt-get install python-django libapache2-mod-python python-psycopg2

Also, check the mod_python Apache module is enabled:

a2enmod mod_python

== Example Apache VHost configuration ==

<VirtualHost * >
DocumentRoot /var/www/django/clientsite
ServerName www.clientsite.co.nz
ServerAlias clientsite.co.nz

# Enable mod_python handler and django config
<Location "/">
SetHandler python-program
PythonHandler django.core.handlers.modpython
PythonPath "['/var/www/django'] + sys.path"
SetEnv DJANGO_SETTINGS_MODULE clientsite.settings
PythonDebug Off
</Location>

# disable mod_python for static content - adjust as required
<Location "/media">
SetHandler None
</Location>

# some variation on the following - omit or adjust as required
<LocationMatch "\.(jpg|gif|png)$">
SetHandler None
</LocationMatch>

</VirtualHost>

This config enables the mod_python handler for the root / URL, and disables it for the media subdirectory and image URLs. Features to note:

* The ''PythonPath'' setting. Note that the path added here is the '''parent''' directory of the document root.
* The ''DJANGO_SETTINGS_MODULE'' environment variable
* ''PythonDebug'' - should be explicitly set to "off"

== Static Content ==

If you are using the django admin interface from the Debian python-django package, you will need to create a symbolic link to the admin media folder in the clientsite directory, for example:

ln -s /usr/share/python-support/python-django/django/contrib/admin/media /var/www/django/clientsite/media

Alternitavely one could configure the Location directive to fetch content from the original path.

For chunky sites, have all the static content served from a separate box using a lightweight HTTP server (lighttpd).

== References ==
* Django online documentation - [http://www.djangoproject.com/documentation/modpython/ "How to use Django with mod_python"].

[[Category:Django]] [[Category:Python]] [[Category:Apache]]

@@ Line 30: / Line 30: @@
     AliasMatch /([^/]*\.(gif|png|jpg)) ''/path/to/myproject'''/static/$1
     <Directory ''/path/to/myproject''/static>
-      Order deny,allow
+      Require all granted
     </Directory>

← Older revision		Revision as of 02:38, 24 October 2014
Line 1:		Line 1:
		+	__NOTOC__
	Setting up Django on Apache 2 is relatively straightforward, but with a few kinks noted herewith.		Setting up Django on Apache 2 is relatively straightforward, but with a few kinks noted herewith.

@@ Line 2: / Line 2: @@
 == Django Requirements ==
 * Python >= 2.4
 * Apache 2
-* mod_python - Apache module to support Python code, similar to mod_perl
+* mod_wsgi - Apache module for Python apps
 * PostgreSQL >= 8.0
 * python-psycopg2 - PostgreSQL client library for Python
 * python-imaging  - Python Imaging library
-* memcached and python-memcache ''(optional but reccommended)''
+* memcached and python-memcache ''(optional but recommended)''
 == Preparation ==
-Django can be installed from the Debian packaged version, or fetched with SVN or with git from the [http://git.catalyst.net.nz/gitweb?p=django.git Catalyst Django git mirror]. and mod_python and psycopg2 can be simply installed using apt-get:
+Django can be installed from the Debian packaged version, and mod_wsgi and psycopg2 can be simply installed using apt-get:
-  apt-get install python-django libapache2-mod-python python-psycopg2
+  apt-get install python-django libapache2-mod-wsgi python-psycopg2
-Also, check the mod_python Apache module is enabled:
+Check the mod_python Apache module is enabled:
-  a2enmod mod_python
+  a2enmod wsgi
 == Example Apache VHost configuration ==
-  <VirtualHost * >
+  <VirtualHost *:80>
-     DocumentRoot /var/www/django/clientsite
+   ServerName www.clientsite.co.nz
-     # disable mod_python for static content - adjust as required
+   # static content (for now, but separate domain best)
-     <Location "/media">
+   AliasMatch /([^/]*\.(gif|png|jpg)) ''/path/to/myproject'''/static/$1
-         SetHandler None
+   <Directory ''/path/to/myproject''/static>
-     </Location>
+     Order deny,allow
+      Allow from all
-     # some variation on the following - omit or adjust as required
+   </Directory>
   </VirtualHost>
-This config enables the mod_python handler for the root / URL, and disables it for the media subdirectory and image URLs. Features to note:
+== Example WSGI file ==
-* The ''PythonPath'' setting. Note that the path added here is the '''parent''' directory of the document root.
+This would go in the <tt>''/path/to/myproject''/django.wsgi</tt> file, as specified in the Apache WSGIScriptAlias directive.
-== Static Content ==
+ import os
+ import sys
-If you are using the django admin interface from the Debian python-django package, you will need to create a symbolic link to the admin media folder in the clientsite directory, for example:
+ # You may also need to add the Django path
-  ln -s /usr/share/python-support/python-django/django/contrib/admin/media /var/www/django/clientsite/media
+  path = "''/path/to/myproject''"
+ if path not in sys.path:
-Alternitavely one could configure the Location directive to fetch content from the original path.
+     sys.path.append(path)
-−
-For chunky sites, have all the static content served from a separate box using a lightweight HTTP server (lighttpd).
+ os.environ["DJANGO_SETTINGS_MODULE"] = "''myproject''.settings"
+ import django.core.handlers.wsgi
-== External Links ==
+ application = django.core.handlers.wsgi.WSGIHandler()

@@ Line 63: / Line 63: @@
 For chunky sites, have all the static content served from a separate box using a lightweight HTTP server (lighttpd).
-== References ==
+== External Links ==
-* Django online documentation - [http://www.djangoproject.com/documentation/modpython/ "How to use Django with mod_python"].
+* [http://www.djangoproject.com/documentation/ Django documentation] - [http://www.djangoproject.com/documentation/modpython/ "How to use Django with mod_python"].
 [[Category:Django]] [[Category:Python]] [[Category:Apache]]