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

  pip install django

Install Django Conntrackt::

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

Start a new Django Conntrackt project::

  django-admin.py startproject conntrackt_test

Edit configuration file ``conntrackt_test/conntrackt_test/settings.py`` to set-up

some basic settings:

#. Under ``DATABASES`` set parameter ``ENGINE`` to ``'django.db.backends.sqlite3'``.

#. Under ``DATABASES`` set parameter ``NAME`` to ``'conntrackt_test.sqlite'``.

#. Under ``INSTALLED_APPS`` uncomment the line ``'django.contrib.admin'``.

#. Under ``INSTALLED_APPS`` append line ``'conntrackt',``.

#. Append the following lines to the end of the file::

     from django.conf.global_settings import TEMPLATE_CONTEXT_PROCESSORS

     TEMPLATE_CONTEXT_PROCESSORS += (

         "django.core.context_processors.request",

     )

Edit the URL configuration file ``conntrackt_test/conntrackt_test/urls/.py`` to

set-up the URLs for the admin website and Conntrackt itself:

#. At the top of the file, add line ``from django.http import HttpResponseRedirect``.

#. Uncomment line ``from django.contrib import admin``.

#. Uncomment line ``admin.autodiscover()``.

#. Uncomment line ``url(r'^admin/', include(admin.site.urls)),``

#. Under ``urlpatterns`` append lines::

     url(r'^$', lambda r : HttpResponseRedirect('conntrackt/')),

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

Set-up the database for the project::

  python manage.py syncdb

You will be prompted to provide some additional information:

#. When prompted to create a superuser, answer ``yes``.

#. Provide the desired username when prompted for it.

#. Provide the desired e-mail address when prompted for it.

#. Provide the desired password for created user.

After this the project is fully configured to run Django Conntrackt. Run the

Django development server (good enough for testing, but don't use it in

production)::

  python manage.py runserver

You can now explore the functionality of Djang Conntrackt at::

  http://localhost:8000/

If you have any problems getting around and understanding how the applications

works, have a look at the :ref:`usage guide <usage>`.

.. _usage:

Usage

=====