Installing Jutda Helpdesk is easy once you have Django up and running. The following guide is taken straight from the README file distributed with the software.

Dependencies

  1. Python 2.3+

  2. Django (post-0.96, eg SVN checkout)

  3. An existing working Django project with database etc. If you cannot log into the Admin, you won't get this product working. For more information on getting Django up and running, see the Django Documentation.

Installation

  1. Place helpdesk in your Python path. I use /var/django, others may use /usr/lib/python2.4/site-packages/ or a similar path.

  2. In your projects' settings.py file, add these lines to the INSTALLED_APPS setting:

    'helpdesk', 'django.contrib.admin',

  3. In your projects' urls.py file, add this line:

    (r'helpdesk/', include('helpdesk.urls')),

    You can substitute helpdesk/ for something else, eg support/ or even ''.

  4. Ensure the admin lines are un-hashed in urls.py. If you use helpdesk at the top of your domain (at /), ensure the admin line comes before the helpdesk line.

  5. In your project directory (NOT the helpdesk directory) run ./manage.py syncdb to create database tables and import the default templates.

  6. Inside your MEDIA_ROOT folder, create a new folder called helpdesk and copy the contents of helpdesk/htdocs/ into it. Alternatively, create a symlink:

    ln -s /path/to/helpdesk/htdocs /path/to/media/helpdesk

    This application assumes all helpdesk media will be accessible at http://MEDIA_PATH/helpdesk/.

  7. Inside your MEDIA_ROOT folder, inside the helpdesk folder, is a folder called attachments. Ensure your web server software can write to this folder - something like this should do the trick:

    chown www-data:www-data attachments/; chmod 700 attachments

    (substitute www-data for the user / group that your web server runs as, eg apache or httpd)

    If all else fails ensure all users can write to it:

    chmod 777 attachments

    This is not recommended, especially if you're on a shared server.

That's all there is to it! You can now see our configuration documentation to help get you up and running.