mod_wsgi (Apache)

If you are using the Apache webserver you should consider using mod_wsgi.

Installing mod_wsgi

If you don’t have mod_wsgi installed yet you have to either install it usinga package manager or compile it yourself.

The mod_wsgi installation instructions cover installation instructions forsource installations on UNIX systems.

If you are using ubuntu / debian you can apt-get it and activate it as follows:

  1. # apt-get install libapache2-mod-wsgi

On FreeBSD install mod_wsgi by compiling the www/mod_wsgi port or by usingpkg_add:

  1. # pkg_add -r mod_wsgi

If you are using pkgsrc you can install mod_wsgi by compiling thewww/ap2-wsgi package.

If you encounter segfaulting child processes after the first apache reload youcan safely ignore them. Just restart the server.

Creating a .wsgi file

To run your application you need a yourapplication.wsgi file. This filecontains the code mod_wsgi is executing on startup to get the applicationobject. The object called application in that file is then used asapplication.

For most applications the following file should be sufficient:

  1. from yourapplication import make_app
  2. application = make_app()

If you don’t have a factory function for application creation but a singletoninstance you can directly import that one as application.

Store that file somewhere where you will find it again (eg:/var/www/yourapplication) and make sure that yourapplication and allthe libraries that are in use are on the python load path. If you don’twant to install it system wide consider using a virtual python instance.

Configuring Apache

The last thing you have to do is to create an Apache configuration file foryour application. In this example we are telling mod_wsgi to execute theapplication under a different user for security reasons:

  1. <VirtualHost *>
  2. ServerName example.com
  3.  
  4. WSGIDaemonProcess yourapplication user=user1 group=group1 processes=2 threads=5
  5. WSGIScriptAlias / /var/www/yourapplication/yourapplication.wsgi
  6.  
  7. <Directory /var/www/yourapplication>
  8. WSGIProcessGroup yourapplication
  9. WSGIApplicationGroup %{GLOBAL}
  10. Order deny,allow
  11. Allow from all
  12. </Directory>
  13. </VirtualHost>