• A minimal installation of Debian Wheezy or newer.
• A Murmur server listening on the default Ice port 6502; a howto for this can be found mumble:benutzerhandbuch:murmur:mumble-server-installieren|here.
  • The icesecretwrite variable in the server´s configuration file is set to 'mymumbleserver.

Installation of the latest version of mumble:benutzerhandbuch:murmur:admin-interfaces:mumble-django|Mumble-Django.

• Mumble-Django will be installed to '/srv/mumble-django'
• All commands are run as 'root'

For Mumble-Django 2.8+ one needs at least Django 1.5, Debian Wheezy delivers 1,4,5 so one must install it himself.

An already installed Django should be removed:

apt-get remove python-django

Now install Pip which can be used to install Django 1.5:

apt-get install python-pip

Now install Django and Django-Registration through Pip:

pip install django==1.5.1 django-registration

The other dependencies can be installed using Debian packages:

apt-get install libapache2-mod-wsgi python-imaging python-zeroc-ice python-qrencode bzip2

mkdir /srv/mumble-django

The latest version of Mumble-Django is always available on Bitbucket (https://bitbucket.org/Svedrin/mumble-django/downloads).

Open that website and click on „Tags“ (grey background in the screenshot) and choose the latest version:<br /> 600px

Here it is version 2.11. In the column „Download“ select the link to the bz2 package.

Now change into the Mumble-Django directory you previously created and download the package onto your server:

cd /srv/mumble-django
wget --no-check-certificate https://bitbucket.org/Svedrin/mumble-django/get/v2.11.tar.bz2

Unpack the archive:

tar xvjf v2.11.tar.bz2 --strip-components 1

The „–strip-components 1“ removes the first path from the unpacked files so that the files are unpacked into the current directory instead of into an automatically new created directory named „Svedrin-mumble-django-xxxxxxxx“.

Now you can remove the archive:

rm v2.11.tar.bz2

If you use a Mumble server in version 1.3.0 or later you must first change a .py file of Mumble-Django, see here.

Set login credentials for the admin account of the Mumble-Djagno web interface:

python pyweb/manage.py syncdb

Creating tables ...
Creating table auth_permission
Creating table auth_group_permissions
Creating table auth_group
Creating table auth_user_user_permissions
Creating table auth_user_groups
Creating table auth_user
Creating table django_admin_log
Creating table django_content_type
Creating table django_session
Creating table django_site
Creating table mumble_mumbleserver
Creating table mumble_mumble
Creating table mumble_mumbleuser

You just installed Django's auth system, which means you don't have any superusers defined.
Would you like to create one now? (yes/no): yes
Username (leave blank to use 'root'):
E-mail address: xxx@domain.tld
Password:
Password (again):
Superuser created successfully.

This user is not related in any way to your Linux user root.

Now configure the connection type and set it to use Ice:

--- Murmur connection info ---
  1) DBus -- net.sourceforge.mumble.murmur  (Murmur 1.1.8 or older)
  2) ICE  -- Meta:tcp -h 127.0.0.1 -p 6502  (Recommended)
 
Enter 1 or 2 for the defaults above, nothing to skip Server detection,
and if the defaults do not fit your needs, enter the correct string.
Whether to use DBus or Ice will be detected automatically from the
string's format.
 
Service string: 2
Please enter the Ice secret (if any): meinmumbleserver
Found new Murmur instance 1 on bus 'Meta:tcp -h 127.0.0.1 -p 6502'...
Successfully finished Servers and Players detection.
To add more servers, run this command again.
Installing custom SQL ...
Installing indexes ...
Installed 0 object(s) from 0 fixture(s)

Now Mumble-Django should be able to connect your Murmur

The settings of Mumble-Django are located in the file pyweb/settings.py. Though nothing needs to be changed now.

We use Apache in this tutorial. <ref>See [http://docs.mumble-django.org/de/web_server_setup.html#de-web-server-setup here] for a very detailed instruction on setting up your webserver.</ref>

Im Ordner /srv/mumble-django/etc/apache2 liegen zwei .conf-Dateien bereit.

Wir nehmen mal die dedicated_vhost-Variante, da sicher noch andere Web-Seiten auf dem Server laufen sollen, außerdem wird dies von Mumble-Django empfohlen:

cp /srv/mumble-django/etc/apache2/dedicated_vhost.conf /etc/apache2/sites-available/mumble-django

Die Datei /etc/apache2/sites-available/mumble-django muss allerdings noch angepasst werden, da django und django-registration unter /usr/local liegen und /mumble/media verlegt wurde ¹⁾; aus

        Alias                   /static/admin/  /usr/share/pyshared/django/contrib/admin/static/admin/
        Alias                   /static/        /srv/mumble-django/htdocs/
        Alias                   /mumble/media/  /srv/mumble-django/pyweb/mumble/media/

wird deshalb

        Alias                   /static/admin/  /usr/local/lib/python2.7/dist-packages/django/contrib/admin/static/admin/
        Alias                   /static/mumble/ /srv/mumble-django/pyweb/mumble/static/mumble/
        Alias                   /static/        /srv/mumble-django/htdocs/

Servername usw. müssen in dieser Datei natürlich an die eigene Domain oder die IP-Adresse des Servers angepasst werden.

Dann wird die Seite noch mit a2ensite mumble-django aktiviert. Läuft auf dem Apache-Server sonst nichts außer dem neuen Admininterface, so muss man noch mit a2dissite default die Standardseite deaktivieren. Nach einem Neustart von Apache mit apache2ctl restart ist alles fertig.

Da in unserem Fall Apache das Mumble-Django ausliefern soll, sollten wir dem Benutzer www-data dieses Verzeichnis geben: ²⁾

chown -R www-data: /srv/mumble-django

Now you can login to Mumble-Django; open the path on your webserver configured in the Apache configuration file (in this example http://example.com) and you get the following: Mumble-django installation 0.png

The QR-Code links to http://example.com/mumble/embed/1.

Here you can login as user root:<br /> Mumble-django installation 1.png

After setting up your server it looks much nicer, for example like this:<br /> 600px

Have fun with your Mumble-Django.