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+http://code.majic.rs/conntrackt#egg=conntrackt

Warning

You will need to update the pip installation in your virtual environment if you get the following error while running the above command:

AttributeError: 'NoneType' object has no attribute 'skip_requirements_regex'

You can update pip to latest version with:

pip install -U pip

After this you should proceed to configure your Django installation.

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:

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

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

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

3. 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.