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

Django Conntrackt can be installed through one of the following methods:

* Using *pip*, which is the recommended way for production
  websites.


Using pip
---------

In order to install latest stable release of Django Conntrackt using *pip*, use
the following command::
  pip install conntrackt

In order to install the latest development version of Django Conntrackt from
Mercurial repository, use the following command::

 pip install -e hg+https://hg.majic.rs/conntrackt#egg=conntrackt

After this you should proceed to :ref:`configure your Django installation <configuring-django>`.


.. _configuring-django:

Configuring your Django installation
====================================

Once the Django Conntrackt has been installed, you need to perform the following
steps in order to make it available inside of your Django project:

#. Edit your project's settings configuration file (``settings.py``), and update
   the ``INSTALLED_APPS`` to include applications ``south``, ``braces`` and ``conntrackt``.

#. Edit your project's URL configuration file (``urls.py``), and add the
   following line to the ``urlpatterns`` setting::

     url(r'^conntrackt/', include('conntrackt.urls')),

#. Create the necessary tables used for Django Conntrackt by running::

   ./manage.py syncdb

After this the Django Conntrackt application will be available under the
``/conntrackt/`` path (relative to your Django project's base URL).

If you have enabled ``django.contrib.admin``, you should be able to add new
Conntrackt data through the admin interface.