Apache WSGI Configuration

RhodeCode Enterprise can also be set up with Apache under mod_wsgi. To configure this use the following steps.

  1. Install mod_wsgi using the following command: aptitude install libapache2-mod-wsgi.
  2. Enable mod_wsgi using the following command: a2enmod wsgi
  3. Create a wsgi dispatch script, using the following examples.
WSGIDaemonProcess pylons \
threads=4 \
# check the python virtual env location
# Check the install location
WSGIScriptAlias / /home/web/rhodecode/dispatch.wsgi
WSGIPassAuthorization On
  # user=www-data group=www-data # Enable if running Apache as root


Do not set processes=num in this configuration file. Running RhodeCode Enterprise in multiprocess mode with Apache is not supported.

The following is an example wsgi dispatch script.

import os
os.environ["HGENCODING"] = "UTF-8"
os.environ['PYTHON_EGG_CACHE'] = '/home/web/rhodecode/.egg-cache'

# Set the current dir

import site

from paste.deploy import loadapp
from paste.script.util.logging_config import fileConfig

application = loadapp('config:/home/web/rhodecode/production.ini')


When using mod_wsgi the same version of Mercurial must be running in your system’s Python environment and on RhodeCode Enterprise. To check the RhodeCode Enterprise version, on the interface go to Admin ‣ Settings ‣ System Info