8.1.3. Configuring Apache with mod_wsgi

Using mod_wsgi is recommended over using mod_python. It’s one of the faster and more efficient ways of serving hgweb(dir).

You can use the hgwebdir.wsgi script (it lives where other Mercurial scripts live, and works with Mercurial 1.0 and later), which references a hgwebdir.conf file in the CONFIG variable:

from mercurial.hgweb.hgweb_mod import hgweb  from mercurial.hgweb.hgwebdir_mod import hgwebdir    CONFIG = '/var/hg/public.config'  application = hgwebdir(CONFIG)

This is really an ordinary Python module, but it uses a wsgi extension to make it clear what its use is.

You then need to add this to your httpd.conf (or the vhost config):

WSGIScriptAlias / /var/hg/script/public.wsgi  <Directory /var/hg/script>  Order deny,allow  Allow from all  </Directory>

Since you’re allowing some permissions to the directory the .wsgi script is in, you probably don’t want to put the script in a directory that also contains your repositories.

NOTE: the default hgwebdir.wsgi uses ‘hgweb.config’ as configuration path. This may not be what you expect. If you find yourself with a working but empty installation, try to set this to the full path where your hgweb.config is situated