============
Installation
============

Sumatra may be downloaded from the `Python Package Index`_ or from the `INCF Software Centre`_.
To install it, first unpack the tar archive::

    $ tar xzf Sumatra-0.1.tar.gz
    $ cd Sumatra-0.1
    # python setup.py install
    
The last step may need to be run as root, or using sudo.

Installing Django
-----------------

If you wish to use the web interface, you will also need to install Django_. On
Linux, you may be able to do this via your package management system: see
http://code.djangoproject.com/wiki/Distributions.

Otherwise, it is very easy to install manually: see
http://docs.djangoproject.com/en/dev/topics/install/#installing-official-release

Installing Python bindings for your version control system
----------------------------------------------------------

Sumatra currently supports Mercurial_ and Subversion_. If you are using Subversion,
you will need to install the pysvn bindings from http://pysvn.tigris.org/project_downloads.html.

.. _Django: http://www.djangoproject.com
.. _Mercurial: http://www.selenic.com/mercurial/
.. _Subversion: http://subversion.tigris.org/
.. _`Python Package Index`: http://pypi.python.org/pypi/sumatra/
.. _`INCF Software Centre`: http://software.incf.org/software/sumatra/home/download/
