Version 40 (modified by 17 years ago) ( diff ) | ,
---|
Server arrangements
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
FastCGI
Twisted.web2
- See #172.
nginx
- See Django on nginx and Start Django with nginx.
I've been serving up my django site via nginx for a short while now and wanted to report my setup so that others may give it a shot. My performance over the previous setup with lighttpd is a bit better. This setup uses much less cpu and memory to achieve much better throughput and response time. The simple syntax of the nginx.conf allows you to setup a cluster of backend processes quite easily to handle load. Currently this is my nginx.conf relevant to my django site. You can reference the above links for more information about additional options.
upstream djangoserv { server 127.0.0.1:8801; } server { listen 80; root /path/to/app; server_name test.local.domain; access_log /path/to/logs/appname-access.log main; error_log /path/to/logs/appname-error.log; location /styles { root /path/to/styles; } location /javascripts { root /path/to/javascripts; } location ~* ^.+\.(jpg|jpeg|gif|png|ico|css|zip|tgz|gz|rar|bz2|doc|xls|exe|pdf|ppt|txt|tar|mid|midi|wav|bmp|rtf|js|mov) { access_log off; expires 30d; } location / { # host and port to fastcgi server fastcgi_pass 127.0.0.1:8801; fastcgi_param PATH_INFO $fastcgi_script_name; fastcgi_param REQUEST_METHOD $request_method; fastcgi_param QUERY_STRING $query_string; fastcgi_param SERVER_NAME $server_name; fastcgi_param SERVER_PORT $server_port; fastcgi_param SERVER_PROTOCOL $server_protocol; fastcgi_param CONTENT_TYPE $content_type; fastcgi_param CONTENT_LENGTH $content_length; fastcgi_pass_header Authorization; fastcgi_intercept_errors off; } }
Once you fire up nginx you will need to start your nginx fastcgi processes. I simply use:
python2.4 manage.py runfcgi method=threaded host=127.0.0.1 port=8801
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. Version 1.2 now supports SSL. Rock solid behind a proxy like NGINX.
Devserver - 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
Differences between Devserver and production
- devserver_and_apache_differences - tips to help ease the transition.