Server arrangements

TOC

Because Django uses ​WSGI, it can run on any WSGI-compatible Web server. Here's how to run Django on various server arrangements.

Apache

Apache with mod_python

• See the ​official documentation.
• you can also look at the django_apache_and_mod_rewrite small tutorial.

Apache with FastCGI

• See the ​official documentation.
• Mac OS X users, see Django with FCGI on OS X.

Apache with SCGI

• ​SCGI can be used with Apache ​like this. It builds on stuff from the Apache+FCGI documentation above.

The material at simon.bofh.ms has been hard to get - server sometimes responds, sometimes not IME. In any event, #3047 has patches, and seems to be on track to become the official way to do SCGI with Django.

Apache with mod_wsgi

• See the ​mod_wsgi official docs.
• See this page for a step by step procedure to configure it on windows.

lighttpd

lighttpd with Apache

• See ​this page.

lighttpd with FastCGI

• See the ​official documentation.
• Django/lighttpd/FastCGI ​instructions for use on TextDrive shared hosting accounts are also available.

lighttpd with SCGI

• See ​Running Django using SCGI through LightTPD.

FastCGI

• MultipleVersionsWithFCGI.
• FastCGI init scripts

Twisted.web2

• See #172.

nginx

• See ​Django on nginx and ​Start Django with nginx.

Django behind/inside Zope

It's possible to query a Django site from Zope or Plone and return the result. This allows you to include a Django site inside a pre-existing Zope/Plone site. It's good for custom content that you don't want to use existing Zope technologies to develop. For the code, see ​this partly documented file. It's in a temporary location for the time being; for more info, e-mail jeff (at) bitprophet (dot) org.

CGI

Running Django as a traditional CGI is possible and would work the same as running any other sort of Python CGI script, but is generally not recommended.

With traditional CGI, the program which will be run -- in this case, Django plus a Django-powered application -- is loaded from disk into memory each time a request is served, which results in a significant amount of processing overhead and much slower responses. FastCGI and SCGI, in contrast, load the code only once -- when the server starts up -- and keep it in memory as long as the server is running, resulting in much faster responses.

If that hasn't put you off and you still need CGI, take a look at #2407.

CherryPy and WSGI

• See ​Run your Django app with the CherryPy server - DjangoCerise.

Django built-in development server

• Once again, this isn't for production use, but the ​official documentation may help. Ticket #2996 has a patch to daemonize which may be useful