Last update at August 1st, 2009.

This guide explains how to deploy Web.py on Nginx with Fastgci. This guide is taken from the Web.py cookbook and serves as a backup. It was orginally written by me (Frank).

Requirements

• Nginx 0.8.* or 0.7.* (with fastcgi and rewrite module).
• Webpy 0.32
• Spawn-fcgi 1.6.2
• Flup

Older versions may work, but are not tested.

Resources

• Nginx wiki
• Spawn-fcgi
• Flup

Notes

• You may replace index.py with your own file name.
• /path/to/www Is the path to the directory where your webpy application is located.
• /path/to/www/index.py is the full path to your python file.
• Do not run anything until you are at Run.

Nginx configuration

location / {
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $fastcgi_script_name;  # [1]
    fastcgi_param PATH_INFO $fastcgi_script_name;        # [2]
    fastcgi_pass 127.0.0.1:9002;
}

To serve static files add this:

location /static/ {
    if (-f $request_filename) {
    rewrite ^/static/(.*)$  /static/$1 break;
    }
}

Note: the address and port may be different.

Spawn-fcgi

You're free to choose which address, port, directory and filename to use, but be sure to adjust the Nginx configuration.

Start

#!/bin/sh
spawn-fcgi -d /path/to/www -f /path/to/www/index.py -a 127.0.0.1 -p 9002

Shutdown

#!/bin/sh
kill `pgrep -f "python /path/to/www/index.py"`

Hello world!

Save the following code in your www directory and call the file index.py (or whatever you like). The following line is required: web.wsgi.runwsgi = lambda func, addr=None: web.wsgi.runfcgi(func, addr).

#!/usr/bin/env python
# -*- coding: utf-8 -*-

import web

urls = ("/.*", "hello")
app = web.application(urls, globals())

class hello:
    def GET(self):
        return 'Hello, world!'

if __name__ == "__main__":
    web.wsgi.runwsgi = lambda func, addr=None: web.wsgi.runfcgi(func, addr)
    app.run()

Note: make your file executable by doing chmod +x index.py. You'll get errors if it isn't executable.

Run

1. Start a process with spawn-fcgi.
2. Start Nginx.

To check if it runs do ps aux | grep index.py or simply visit the page in your browser.

To reload your configuration:

/path/to/nginx/sbin/nginx -s reload

And to stop:

/path/to/nginx/sbin/nginx -s stop