Phone: +65-8585-1750

Address: 30 Holland Close, Singapore

nginx and WSGI using Paste

Wed, Jul 13, 2011 mdda OSS Blog Comments

nginx and WSGI using Paste

Paster contains the WSGI server originally incorporated within CherryPy (see Funnily enough, this is a pretty hot contender amongst other Python WSGI webservers (see : Maybe not the best, but because of its ease of set-up (working out-of-the-box for Pyramid and Pylons) it is extremely compelling.

Combining it with NGINX makes for a very easy-to-configure, fast and scalable set-up. Here goes…

Paste reads its configuration from the .INI file :

host = /tmp/SITENAME-python.sock
use = egg:PasteScript#cherrypy
numthreads = 10
timeout = 180
request_queue_size = 200

And the following for nginx configuration (in /etc/nginx/conf.d/SITENAME.conf) :

server {
 server_name SITENAME;
 root /static;
 location / {
  proxy_set_header        Host $host;
  proxy_set_header        X-Real-IP $remote_addr;
  proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
  proxy_set_header        X-Forwarded-Proto $scheme;

  client_max_body_size    10m;
  client_body_buffer_size 128k;
  proxy_connect_timeout   60s;
  proxy_send_timeout      90s;
  proxy_read_timeout      90s;
  proxy_buffering         off;
  proxy_temp_file_write_size 64k;
  proxy_redirect          off;
  proxy_pass http://unix:/tmp/SITENAME-python.sock;
 location ~ ^/(img|js|css|ext|theme)/ {
  root                    /home/USERNAME/static;
  add_header              Cache-Control public;
  #expires                 30d;
  #access_log              off;

In order for the cherrypy server to serve WSGI over a UNIX socket file (rather than a UNIX port) the code needs a small modification (so that socket options aren’t set on the ):

#  ADD THE FOLLOWING TO PasteScript-1.7.3-py2.7.egg/paste/script/
    # Under the line that reads : "bind_addr = (host, int(port))"
    if '/' in host:
        bind_addr = host

    # Under the block (including the lines within it) that reads : "if protocol_version:"
    if '/' in host:

As an alternative to the file socket thing, just use the following syntax in the .INI file :

host =
port = 6501

and the following in the nginx conf :


blog comments powered by Disqus