===================

Deploying GeoDjango

===================

.. warning::

    GeoDjango uses the GDAL geospatial library which is

    not thread safe at this time.  Thus, it is *highly* recommended

    to not use threading when deploying -- in other words, use a 

    an appropriate configuration of Apache or the prefork method

    when using FastCGI through another Web server.

Apache

======

In this section there are some example ``VirtualHost`` directives for 

when deploying using either ``mod_python`` or ``mod_wsgi``.  At this

time, we recommend ``mod_wsgi``, as it is now officially recommended 

way to deploy Django applications with Apache.  Moreover, if

``mod_python`` is used, then a prefork version of Apache must also be

used.  As long as ``mod_wsgi`` is configured correctly, it does not

matter whether the version of Apache is prefork or worker.

.. note::

    The ``Alias`` and ``Directory`` configurations in the the examples

    below use an example path to a system-wide installation folder of Django.  

    Substitute in an appropriate location, if necessary, as it may be

    different than the path on your system.

``mod_wsgi``

------------

Example::

    <VirtualHost *:80>

      WSGIDaemonProcess geodjango user=geo group=geo processes=5 threads=1

      WSGIProcessGroup geodjango

      WSGIScriptAlias / /home/geo/geodjango/world.wsgi

      Alias /media/ "/usr/lib/python2.5/site-packages/django/contrib/admin/media/"

      <Directory "/usr/lib/python2.5/site-packages/django/contrib/admin/media/">

        Order allow,deny

        Options Indexes

        Allow from all

        IndexOptions FancyIndexing

      </Directory>

    </VirtualHost>

.. warning::

    If the ``WSGIDaemonProcess`` attribute ``threads`` is not set to ``1``, then

    Apache may crash when running your GeoDjango application.  Increase the 

    number of ``processes`` instead.

For more information, please consult Django's

:doc:`mod_wsgi documentation </howto/deployment/modwsgi>`.

``mod_python``

--------------

Example::

    <VirtualHost *:80>

      <Location "/">

        SetHandler mod_python

        PythonHandler django.core.handlers.modpython

        SetEnv DJANGO_SETTINGS_MODULE world.settings

        PythonDebug On

        PythonPath "['/var/www/apps'] + sys.path"

      </Location>

      Alias /media/ "/usr/lib/python2.5/site-packages/django/contrib/admin/media/"

      <Location "/media">

        SetHandler None

      </Location>

    </VirtualHost>

.. warning::

   When using ``mod_python`` you *must* be using a prefork version of Apache, or

   else your GeoDjango application may crash Apache.

For more information, please consult Django's

:doc:`mod_python documentation </howto/deployment/modpython>`.

Lighttpd

========

FastCGI

-------

Nginx

=====

FastCGI

-------