------------------------
Mumble-Django for Debian
------------------------

This package contains a Django project wrapped around python-mumble-django
to provide a full web interface.


Using Mumble-Django:
--------------------

After the installation of this package, run mumble-django-configure as root.
This script will allow you to run a series of maintenance commands, such as
installing the database, detecting existing Mumble server instances and
installing the Munin plugin. For the first run of this script, selecting the
default values for each question should be fine, and get your Mumble-Django
installation ready for use.

If you have more than one Murmur installation which you want to manage using
Mumble-Django, just run mumble-django-configure multiple times to detect all
of them.

After you are done, you can browse your MD installation at:
  http://localhost/mumble-django

To alter the location where MD can be reached, take a look at the Apache2
configuration shipped with Mumble-Django. If you want to change the setup, be
sure to update the MUMBLE_DJANGO_URL setting appropriately. For documentation
on the web server configuration, see:
  http://www.mumble-django.org/docs/en/web_server_setup.html


File locations:
---------------
- Configs:        /etc/mumble-django
  - settings.py:  main configuration for Mumble-Django.
  - apache2.conf: VirtualHost config for the Apache2 web server.
- Database:       /var/lib/mumble-django
  contains all data stored in the web interface.
- Source code:    /usr/share/mumble-django
  contains all code necessary to run mumble-django.
