View source

= Introduction =
Murmur is the server component for Mumble. This article is meant to give you the necessary information to configure and run your own server. If you need a step-by-step guide to help you set up a Murmur server, read [[Murmurguide|this]].

'''If you find anything incorrect or missing in this article feel free to add it yourself.'''

= Distribution-specific Murmur =

By default, murmur is configured to run from a regular user account, and on Windows and OSX this is the only way it works. However, on distributions with prepackaged murmur (Debian/Ubuntu), murmur is configured to run as a sytem service, just like your webserver, mailserver and whatever else you've got running. This "global" installation is a ready, turn-key solution, most of the information here does not apply to you. Most packages also include the 'murmur-user-wrapper' script, which does all of the below for you if you want to run as a regular user (including starting DBus).

So, on these systems, you can still run murmur manually, but you will then not benefit from the extensive care that has gone into preparing those packages.

If you need to register users or change the settings of a virtual server, read the section on Advanced Configuration.

= Basic configuration =

The default settings for a murmur server are configured in ''murmur.ini''. Here you can configure the welcome text, port number and other settings. However, these are just default settings and can be overwritten via the [[Ice]] RPC without changing the .ini; if you're running multiple virtual servers, each virtual server has it's own configuration, which is maintained internally by Murmur (see below).

The default port for a Murmur server is UDP and TCP 64738. Have a look at [[URLs]] to see how to publish links to your server.

Adding an authenticated user can be done through various means. Unless you need automated registration of users or authentication against an external database using the functionality built into the client is the easiest method. If you need more control you can use [http://mumble.sourceforge.net/Ice Ice] or [http://mumble.sourceforge.net/DBus DBus].

== Setting the SuperUser password ==

Until you've set a password for the SuperUser, the account will be disabled. You don't need the SuperUser account to run a simple server, but you do need it if you want to give your regular user account any privileges. To set the password on Linux run
 murmurd -supw <password>
This will set the password and return immediately. To run the server remove this parameter. If you are on a debian based system, you may also run
 sudo dpkg-reconfigure mumble-server

If you're on Windows, then you set the password by running
 "C:\Program Files\Mumble\murmur.exe" -supw <password>

= Running Murmur as a regular user =

If you are on Win32, you can simply start ''murmur.exe'' from the command line, or even easier just start it from the Start Menu.

== RPC-Interfaces ==

For full functionality, murmur requires either a working [[DBus]] daemon or [[Ice]] being enabled. We recommend using the [[Ice]] interface, as [[DBus]] is considered deprecated and while it is not planned to remove it anytime soon it will not receive any new functionality.

== Running the daemon ==

To run murmur, simply type
 murmurd
For debugging, you might want to add ''-fg -v'' to the command line, which will stop the program from running in the background and.

By default murmur opens it's configuration file, database file and logfile in your current directory. The configuration file can be overridden with the ''-ini'' parameter, and the database and logfile can be set form the ini file.


= Administration =
This section contains different ways of administrating a murmur Server.

'''Note:''' Most of these interfaces are created and maintained by third parties and the Mumble developers have no influence on the stability and/or security of these projects.

== Web-Interfaces ==

There are several browser based interfaces which can be used to administrate the Murmur server. If you need something very basic or want to create your own interface you should take a look at Murmurs [http://mumble.git.sourceforge.net/git/gitweb.cgi?p=mumble;a=tree;f=scripts script folder] which contains some basic web-interface examples which use [[Ice]] or [[DBus]].
Additionally the following table contains a collection of more elaborate Web-Interfaces:

{|border="0" cellpadding="2" cellspacing="1" style="background:#e2e2e2;" class="sortable"
! Name
! Technology
! [[DBus]]
! [[Ice]]
! 1.1.8
! 1.2.0
! Comment
! Weblink

|-bgcolor="#f8f8ff"
| [[Mumble PHP Interface]]
| [http://php.net/ PHP]
| bgcolor=#ffdddd | No
| bgcolor=#ddffdd | Yes
| bgcolor=#ddffdd | Yes
| bgcolor=#ffdddd | No
| User and Admin functionality
| [http://kissaki.clandooc.de/mumble/interfaces/PHP_Interface.php]


|-bgcolor="#f8f8ff"
| [[MAP - Mumb1e Admin Plugin]]
| [http://php.net/ PHP]
| bgcolor=#ddffdd | Yes
| bgcolor=#ddffdd | Yes
| bgcolor=#ddffdd | Yes
| bgcolor=#ddffdd | planed
| Webinterface to manage Server User, Plugin User and virtual Servers; request function for Server Users; useful for Server hosting; uses DBUS or Slice or nothing; Channelviewer for own homepage; German, English, Frensh; Template functions and more! 
| [http://www.mumb1e.de/]

|-bgcolor="#f8f8ff"
| [[MurmurCP]]
| [http://www.asp.net/ ASP.NET] + [http://www.zeroc.com/ ICE]
| bgcolor=#ffdddd | No
| bgcolor=#ddffdd | Yes
| bgcolor=#ddffdd | Yes
| bgcolor=#ffdddd | No
| Multiple Virtual Servers, Registration, Server Status, Forgot Password
| [http://murmurcp.hiddenservers.org]

|-bgcolor="#f8f8ff"
| [[Mumble-Django]]
| [http://www.python.org Python] + [http://www.djangoproject.com Django]
| bgcolor=#ddffdd | Yes
| bgcolor=#ddffdd | Yes
| bgcolor=#ddffdd | Yes
| bgcolor=#ddffdd | Yes
| Channel viewer, admin panel, multiserver, registration, textures
| [http://bitbucket.org/Svedrin/mumble-django/wiki/Home]

|-bgcolor="#f8f8ff"
| [[Simpleregister]]
| [http://php.net/ PHP]
| bgcolor=#ffdddd | No
| bgcolor=#ddffdd | Yes
| bgcolor=#ddffdd | Yes
| bgcolor=#ffdddd | No
| Extended script from the sample folder
| [http://kissaki.clandooc.de/mumble/interfaces/simpleregister.php]

|-bgcolor="#f8f8ff"
| [[Mumble Admin Ice PHP]]
| [http://php.net/ PHP]
| bgcolor=#ffdddd | No
| bgcolor=#ddffdd | Yes
| bgcolor=#ddffdd | Yes
| bgcolor=#ffdddd | No
| Admin functionality
| [http://bitbucket.org/gallagher/mumble-admin-ice-php/downloads/Mumble_Admin.zip]
|}

<small>Note: We recommend using a preferably [[Ice]] or at least [[DBus]] capable interface.</small>

== Standalone applications ==
{|border="0" cellpadding="2" cellspacing="1" style="background:#e2e2e2;" class="sortable"
! Name
! OS
! [[DBus]]
! [[Ice]]
! Comment
! Weblink

|-bgcolor="#f8f8ff"
| [[Murmur Admin Console]]
| [http://de.wikipedia.org/wiki/Microsoft_Windows Windows]
| bgcolor=#ddffdd | Yes
| bgcolor=#ffdddd | No
| Add, edit and delete players over SSH
| [http://bograt.com/Murmur/]
|}

== Commandline-Interfaces ==
{|border="0" cellpadding="2" cellspacing="1" style="background:#e2e2e2;" class="sortable"
! Name
! OS
! [[DBus]]
! [[Ice]]
! Comment
! Weblink

|-bgcolor="#f8f8ff"
| [[MurmurCL]]
| multi-platform
| bgcolor=#ffdddd | No
| bgcolor=#ddffdd | Yes
| Commandline interface written in [http://www.python.org Python]
| [http://d0t.dbclan.de/dump/murmurcldist.exe win32 exe] / [http://nodefab.de/git/?p=mumble-scripts.git;a=blob_plain;f=murmurcl.py;hb=HEAD python source]

|-bgcolor="#f8f8ff"
| [[mice]]
| multi-platform
| bgcolor=#ffdddd | No
| bgcolor=#ddffdd | Yes
| Helper script written in [http://www.python.org Python]
| [http://nodefab.de/git/?p=mumble-scripts.git;a=blob_plain;f=mice.py;hb=HEAD]

|-bgcolor="#f8f8ff"
| [[RegMum]]
| [http://de.wikipedia.org/wiki/Microsoft_Windows Windows]
| bgcolor=#ddffdd | Yes
| bgcolor=#ffdddd | No
| Bat script
| [http://mumble.sourceforge.net/DBus_scripts#Windows]

|-bgcolor="#f8f8ff"
| [[mmctl]]
| [http://www.python.org Python]
| bgcolor=#ddffdd | Yes
| bgcolor=#ffdddd | No
| 1.1.8
| Easy to use script for managing servers and adding users locally
| [http://github.com/mbr/mmctl]
|}

== Manual configuration using DBus ==

If you are not able to use an additional application for administrating Murmur there is still the possibility of manually communicating with the server using [[DBus]]. You can find detailed information on this in our [[DBus|DBus article]].

= Alternative Murmur implementations =
The Mumble team appreciates and supports the implementation of the Mumble protocol. Unlike other proprietary applications everyone is free to write his own Mumble server software and add it to this list. 
== uMurmur ==
uMurmur is a minimalistic Murmur implementation without dependency on QT-core. It lacks features of Murmur but aims at working well on embedded devices like routers. It currently supports 1.1.x Mumble clients. Read more at [http://code.google.com/p/umurmur/ the uMurmur project page].
[[Category:Documentation]]