Difference between revisions of "Running Murmur"

From Mumble Wiki
Jump to: navigation, search
m (Basic configuration)
(Alternative Murmur Implementations: Edited introduction. Added a note to uMurmur and deleted references to very old releases)
 
(175 intermediate revisions by 19 users not shown)
Line 1: Line 1:
Murmur is the server component for Mumble.
+
'''If you find anything incorrect or missing in this article feel free to add it yourself. After you register, you must wait three days before you can edit a page.'''
 +
= Introduction =
 +
{{Notice
 +
|message=For a step-by-step guide to setting up a Murmur server, read '''[[Murmurguide|Murmur Guide]]'''.
  
* Please note that in this page there are some commands that are very long. It will go beyond the margin of your screen. Therefore double click the command so it will highlight, and then copy paste it.
+
}}
= Distribution-specific Murmur =
+
Murmur is the server component for Mumble. This article is meant to give you the necessary information to configure and run your own server.
  
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).
+
= Distribution-Specific Murmur =
  
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.
+
By default, Murmur is configured to run from a regular user account, and on Windows and OSX this is the only way it works.  
  
If you need to register users or change the settings of a virtual server, read the section on Advanced Configuration.
+
However, on distributions with prepackaged Murmur (Debian/Ubuntu), Murmur is configured to run as a system service, just like your webserver, mailserver and whatever else you have 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).
  
= Basic configuration =
+
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.
  
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; if you're running multiple virtual servers, each virtual server has it's own configuration, which is maintained internally by Murmur (see below).
+
If you need to register users externally, or change the settings of a virtual server, read the section on Advanced Configuration.
  
The default port for a Murmur server is UDP and TCP 64738.
+
= Basic Configuration =
  
Adding an authenticated user can be done through various means, read [http://mumble.sourceforge.net/Running_Murmur#Detailed_explanation_of_user_management below] for instructions on using DBus to add a user. You can use [http://mumble.sourceforge.net/ICE ICE] or [http://mumble.sourceforge.net/DBus DBus] or you can directly edit the database (highly discouraged because of the potential problems associated with doing this, do this if you have absolutely no other way to add a user).
+
== Settings, Ports, and Authentication ==
 +
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 its own configuration, which is maintained internally by Murmur (see below).
  
== Setting the SuperUser password ==
+
The default port for a Murmur server is UDP and TCP 64738.
 +
<br>
 +
Have a look at [[Mumble URL]] to see how to publish links to your server, and [[SRV_Record | SRV Record configuration]].
  
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
+
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 [[Ice]] or [[DBus]].
murmurd -supw <password>
 
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
+
== Setting the SuperUser Password ==
"C:\Program Files\Mumble\murmur.exe" -supw <password>
+
{{Notice
 +
|message=Note this command can be run seperately while the server is running to change the password without restarting.  Also note that in 1.2.2 at least, you must run the server normally at least once before trying to set this.
 +
}}
  
= Running Murmur as a regular user =
+
{{Notice
 +
|message=For older versions the SuperUser account is disabled until you setup the password. 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.
 +
}}
  
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.
+
In version >=1.2.4 the SuperUser password is generated automatically on the first server start. You can find it in the logfile. Search for an entry like <code><W>2013-09-03 11:23:44.516 1 => Password for 'SuperUser' set to 'supersecretpassword'</code>. You can of course change this password.
  
== DBus on Linux/OSX ==
+
To set/change the password on the Linux static server, run
 +
murmur.x86 -ini <path to configuration file> -supw <password> [srv]
 +
To set the password on Debian-based systems, run
 +
<pre>
 +
# EITHER use the dpkg management facilities
 +
sudo dpkg-reconfigure mumble-server
  
For full functionality, murmur requires a DBus daemon. We need an isolated daemon, different from the one running under, say, a X11 session, so we specifically spawn our own. The following small shell script will ensure a deamon is ready (copied from ''murmur-user-wrapper''):
+
# OR run the server binary manually
<pre>
+
sudo -i murmurd -ini /etc/mumble-server.ini -supw <password> [srv]
#! /bin/bash
 
DIR=$HOME/murmur
 
DBUSFILE=$DIR/.dbus.sh
 
DBUS_SESSION_BUS_ADDRESS=invalid:/
 
[ -f $DBUSFILE ] && . $DBUSFILE
 
if ! dbus-send --print-reply --dest=org.freedesktop.DBus --type=method_call / org.freedesktop.DBus.GetId 2> /dev/null > /dev/null; then
 
  echo "Launching D-Bus session"
 
  dbus-launch --sh-syntax > $DBUSFILE
 
  . $DBUSFILE
 
  if ! dbus-send --print-reply --dest=org.freedesktop.DBus --type=method_call / org.freedesktop.DBus.GetId 2> /dev/null > /dev/null; then
 
    echo "Failed to launch session DBUS, bailing out."
 
  fi
 
fi
 
 
</pre>
 
</pre>
Before running this for the first time, make sure ~/murmur exists
+
To set the password on Windows systems, run
  mkdir $HOME/murmur
+
  <path to murmur.exe> -ini <path to configuration file> -supw <password> [srv]
  
And to use it
+
Make sure the <tt>-ini</tt> parameter is the same as for running the server normally to make sure the password gets set in the right database file. If the command does not seem to work, double-check that you are supplying the right path.
source <pathtoscript>
 
  
You should always source this script before starting murmur, and you also need to run it before using any DBus commands.
+
The <tt>[srv]</tt> parameter is the ID of the virtual Mumble-Server you want to change password for. If omitted, ID 1 is used (for the first virtual server).
  
== Running the daemon ==
+
This will only set the password and then terminate, it will not start the server. To run the server, start it without the <tt>-supw</tt> parameter.
  
To run murmur, simply type
+
== Starting Murmur ==
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.
+
To start Murmur,  
  
= Advanced manual configuration using DBus =
+
On a static Linux build, cd to the directory where you extracted the files and do
 +
murmur.x86
 +
On Debian-based,
 +
sudo dpkg-reconfigure mumble-server
 +
On Windows,
 +
<path to murmur.exe> (usually C:\Program Files\Mumble\Murmur.exe)
  
First, make sure Murmur is running and that you have contact with DBus. For Win32, you don't need to do anything, and on all other platforms, you should run the script above.
+
For debugging or real time logging, you might want to add ''-fg -v'' to the command line, which will stop the program from running in the background.
  
== Showing the default configuration ==
+
By default, Murmur opens its 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 from the ini file, using their respective parameters.
  
This is just to verify we have contact with DBus, and to print out the default configuration.
+
= Advanced Configuration and Administration=
dbus-send --print-reply --dest=net.sourceforge.mumble.murmur --type=method_call / net.sourceforge.mumble.Meta.getDefaultConf
 
(if you're running a system DBus based configuration, add ''--system'' before all the other parameters)
 
  
This should print out the default configuration.
+
To make use of a strong server certificate the users will not have to manually accept, please see [[Obtaining a Let's Encrypt Murmur Certificate]] and [[Obtaining a Comodo Murmur certificate]].
  
== Virtual Servers ==
+
{{Notice
 +
|message=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.
  
Listing the servers:
+
Also, nearly all of the basic administration tasks can be completed '''through the client''' when using > Mumble 1.2.x.
dbus-send --print-reply --dest=net.sourceforge.mumble.murmur --type=method_call / net.sourceforge.mumble.Meta.getAllServers
+
}}
 +
== Compatibility With RPC-Interfaces ==
  
Adding a server:
+
For full functionality with an RPC interface, Murmur requires either a working [[DBus]] daemon or [[Ice]] installation that is enabled. We recommend using the [[Ice]] interface; [[DBus]] is considered deprecated and although it will not be removed in the near future, it is not receiving any new functionality. Once you have Murmur working with the RPC interface, you can install a compatible web interface; see below for possible options.
dbus-send --print-reply --dest=net.sourceforge.mumble.murmur --type=method_call / net.sourceforge.mumble.Meta.newServer
 
  
Removing a server:
+
== Authenticating With an External Database/Forum ==
dbus-send --print-reply --dest=net.sourceforge.mumble.murmur --type=method_call / net.sourceforge.mumble.Meta.deleteServer int32:'''<serverid>'''
 
  
Starting a server:
+
===Ice===
dbus-send --print-reply --dest=net.sourceforge.mumble.murmur --type=method_call / net.sourceforge.mumble.Meta.start int32:'''<serverid>'''
+
For phpBB3, there is [https://github.com/mumble-voip/mumble-scripts/tree/master/Authenticators/phpBB3 phpBB3auth]. You must point the python script to the ini file; read the in-source documentation for more infomation.
  
Stopping a server:
+
For SMF (Simple Machines Forum), there is [https://github.com/mumble-voip/mumble-scripts/tree/master/Authenticators/SMF smfauth]. You must point the python script to the ini file; read the in-source documentation for more infomation.
dbus-send --print-reply --dest=net.sourceforge.mumble.murmur --type=method_call / net.sourceforge.mumble.Meta.stop int32:'''<serverid>'''
 
  
== Server configuration ==
+
===DBus===
  
Each virtual server has it's server-specific configuration. If a particular confiuration item is empty, it will fall back to the default configuration, which is specified in the ini file.
+
There is an extended example of how to use the authenticator called ''scripts/dbusauth.pl''. You'll need to configure where your phpBB3 database resides, but once that is done you'll simply have to run the script after starting murmur to allow authentication to be done through the phpBB3 database.
  
Listing the configuration:
+
Any group associations the user has on phpBB3 is copied to a temporary group on a root channel (and by default inherited to all subchannels). Please note that this is a temporary group membership and as such will not show up in the Edit ACL dialogs.
dbus-send --print-reply --dest=net.sourceforge.mumble.murmur --type=method_call / net.sourceforge.mumble.Meta.getDefaultConf
 
dbus-send --print-reply --dest=net.sourceforge.mumble.murmur --type=method_call / net.sourceforge.mumble.Meta.getAllConf int32:'''<serverid>'''
 
  
Setting a configuration item:
+
== 3rd Party Applications ==
dbus-send --print-reply --dest=net.sourceforge.mumble.murmur --type=method_call / net.sourceforge.mumble.Meta.setConf int32:'''<serverid>''' string:"'''<key>'''" string:"'''<value>'''"
 
  
== User management ==
+
If you are planning to administrate your Murmur server with an external 3rd Party Application, see the following pages for further information.
  
If you can run CGI scripts from your user account, the murmur.pl script contains user self-management. Just copy it to your webserver and make it executable (you might need to rename it to murmur.cgi), and it should contain everything needed. If not, this is what you'll need:
+
* '''[[3rd_Party_Applications#Web-Interfaces|Web-Interfaces]]'''
 +
* '''[[3rd_Party_Applications#Standalone Applications|Standalone Applications]]'''
 +
* '''[[3rd_Party_Applications#Commandline-Interfaces|Commandline-Interfaces]]'''
  
Adding a new registration:
+
{{Notice
dbus-send --system --print-reply --dest=net.sourceforge.mumble.murmur --type=method_call /'''<serverid>''' net.sourceforge.mumble.Murmur.registerPlayer string:"'''<username>'''"
+
|message=The aforementioned categories have been moved to the page '''[[3rd_Party_Applications|3rd Party Applications]]'''.
 +
}}
  
Fetching an existing registration:
+
== Manual Configuration Using DBus ==
dbus-send --system --print-reply --dest=net.sourceforge.mumble.murmur --type=method_call /'''<serverid>''' net.sourceforge.mumble.Murmur.getRegistration int32:'''<userid>'''
 
or
 
dbus-send --system --print-reply --dest=net.sourceforge.mumble.murmur --type=method_call /'''<serverid>''' net.sourceforge.mumble.Murmur.getRegisteredPlayers string:"'''<username>'''"
 
 
Updating a registration:
 
dbus-send --system --print-reply --dest=net.sourceforge.mumble.murmur --type=method_call /'''<serverid>''' net.sourceforge.mumble.Murmur.setRegistration int32:'''<userid>''' string:"'''<username>'''" string:"'''<email>'''" string:"'''<password>'''"
 
 
 
== Detailed explanation of user management ==
 
 
 
 
 
*Note you must be running > 1.1.5 Murmur Stable for these commands to work.
 
*If you are running Murmur from a session DBus, then remove the ''--system'' from the ''dbus-send'' commands
 
  
 +
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]].
  
<serverid> is a digit number of the server you have. For instance if you had fifty Murmur servers running, the first server you started would be 1, and the fiftieth server you started would be 50.  
+
= Alternative Mumble Servers =
 +
There are multiple alternative Mumble Servers which support the Mumble protocol. <br>
 +
Everyone is free to implement their own Mumble server software and add it to this list.
  
<userid> is also a digit number such as 4 or 30, depending on how many people are registered in the database. For instance when you run
+
{{Notice
  dbus-send --system --print-reply --dest=net.sourceforge.mumble.murmur --type=method_call /1 net.sourceforge.mumble.Murmur.registerPlayer string:"Name"
+
|message=It is recommended to use the Standard Mumble Server. <br>
you will see after you run this command "int32" and some other text. There will be a number to the right of "int32". This number is the user's UserID.
+
These Servers vary in functionality, so check for features and compatibility before use.
 
+
}}
 
 
So for instance you want to register a user, that user's name was ''Name'', his password was ''passwrd'', and you have one server running.
 
 
 
On Linux you would run
 
  dbus-send --system --print-reply --dest=net.sourceforge.mumble.murmur --type=method_call /1 net.sourceforge.mumble.Murmur.registerPlayer string:"Name"
 
You will then see some text. In it you will see "int32". Let's say you already had 5 users registered^. The number next to "int32" in the terminal would be 6. Remember this number.
 
 
 
Now run
 
dbus-send --system --print-reply --dest=net.sourceforge.mumble.murmur --type=method_call /1 net.sourceforge.mumble.Murmur.setRegistration int32:6 string:"Name" string:"<user's email address>" string:"passwrd"
 
 
 
On Windows you would run
 
"C:\Program Files\Mumble\dbus-send.exe" --print-reply --dest=net.sourceforge.mumble.murmur --type=method_call /1 net.sourceforge.mumble.Murmur.registerPlayer string:"Name"
 
You will then see some text. In it you will see "int32". Let's say you already had 5 users registered^. The number next to "int32" in the command prompt would be 6. Remember this number.
 
 
 
Now run
 
"C:\Program Files\Mumble\dbus-send.exe" --print-reply --dest=net.sourceforge.mumble.murmur --type=method_call /1 net.sourceforge.mumble.Murmur.setRegistration int32:6 string:"Name" string:"<user's email address>" string:"passwrd"
 
 
 
You now have a registered user. "Name" can now login with the username ''Name'' and the password ''passwrd''.
 
 
 
If you want to change Name's registration, do the following command: (let's change Name's name to "Unnamed" and his password to "nopasswrd")
 
 
 
For Linux do
 
dbus-send --system --print-reply --dest=net.sourceforge.mumble.murmur --type=method_call /1 net.sourceforge.mumble.Murmur.setRegistration int32:6 string:"Unnamed" string:"<user's email address>" string:"nopasswrd"
 
 
 
For Windows do
 
"C:\Program Files\Mumble\dbus-send.exe" --print-reply --dest=net.sourceforge.mumble.murmur --type=method_call /1 net.sourceforge.mumble.Murmur.setRegistration int32:6 string:"Unnamed" string:"<user's email address>" string:"nopasswrd"
 
 
 
If you cannot remember the int32 of a player, simply run this command
 
 
 
Linux
 
dbus-send --system --print-reply --dest=net.sourceforge.mumble.murmur --type=method_call /1 net.sourceforge.mumble.Murmur.getRegisteredPlayers string:"<username>"
 
 
 
Windows
 
"C:\Program Files\Mumble\dbus-send.exe" --print-reply --dest=net.sourceforge.mumble.murmur --type=method_call /1 net.sourceforge.mumble.Murmur.getRegisteredPlayers string:"<username>"
 
 
   
 
   
 +
== Grumble ==
 +
Grumble is a Mumble Server based on Go (programming language). <br>
 +
It is in active development by the official Mumble team. <br>
 +
Take a look at the Github Repo: https://github.com/mumble-voip/grumble
  
^If you have just started a new Murmur server, the first user you create will have a UserID of 1. The first UserID, 0, is the SuperUser.
+
{{Notice
 
+
|message=For now Grumble lacks support for some features (e.g. remote control, config system). <br> 
= Web-interfaces =
+
See https://github.com/mumble-voip/grumble#project-status for more details.
 +
}}
  
Have a look at [[URLs]] to see how to publish links to your server.
+
== uMurmur ==
 +
{{Notice
 +
|message=uMurmur is outdated (last updated: 2017). So it is not recommended for use and might not be compatible with recent versions of Mumble.
 +
}}
  
There are several browser based interfaces which can be used to administrate the murmur server:
+
uMurmur is a minimalistic Murmur implementation without dependency on QT-core. It lacks features of the Mumble server, but aims at working well on embedded devices like routers.
* Murmurs [http://mumble.svn.sourceforge.net/viewvc/mumble/trunk/scripts/ script folder] contains some basic web-interface examples, there are [[ICE]] or [[DBus]] based sample scripts.
 
* [http://bitbucket.org/Svedrin/mumble-django/wiki/Home Mumble-Django]: A Murmur config application (using: [http://www.python.org python]+[http://www.djangoproject.com django]+[[DBus]])
 
* [http://kissaki.clandooc.de/mumble/interfaces/PHP_Interface.php Mumble PHP Interface] (currently supports user functionality, admin func. to come) (using: [http://php.net/ PHP] + [[ICE]])
 
* [http://kissaki.clandooc.de/mumble/interfaces/simpleregister.php simpleregister] (using: [http://php.net/ PHP] + [[ICE]]) <small>This is an extended version from the example packed with mumble/murmur.</small>
 
* [https://sourceforge.net/projects/murmurwebadmin/ Murmur WebAdministrator] (using: [http://php.net/ PHP]) <span style="color:red">Not Recommended</span> <small>(outdated and direct connection to the db instead of the recommended way of using [[ICE]] or [[DBus]], thus may result in data loss)</small>
 
  
= Commandline-Interfaces =
+
Read more at [http://umurmur.net the uMurmur project page].
  
List of commandline interfaces:
 
* murmurcl ([http://d0t.dbclan.de/dump/murmurcldist.exe win32 exe] / [http://d0t.dbclan.de/dump/mumble_python/murmurcl.py python source]) (using: [http://www.python.org python]+[[ICE]]) <small><span style="color:red">Experimental</span></small>
 
  
[[Category:Documentation]]
+
[[Category:Documentation English]]

Latest revision as of 21:12, 29 June 2020

If you find anything incorrect or missing in this article feel free to add it yourself. After you register, you must wait three days before you can edit a page.

Introduction

Icons oxygen 48x48 actions view-pim-notes.png
Note:
For a step-by-step guide to setting up a Murmur server, read Murmur Guide.

Murmur is the server component for Mumble. This article is meant to give you the necessary information to configure and run your own server.

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 system service, just like your webserver, mailserver and whatever else you have 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 externally, or change the settings of a virtual server, read the section on Advanced Configuration.

Basic Configuration

Settings, Ports, and Authentication

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 its 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 Mumble URL to see how to publish links to your server, and SRV Record configuration.

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 Ice or DBus.

Setting the SuperUser Password

Icons oxygen 48x48 actions view-pim-notes.png
Note:
Note this command can be run seperately while the server is running to change the password without restarting. Also note that in 1.2.2 at least, you must run the server normally at least once before trying to set this.
Icons oxygen 48x48 actions view-pim-notes.png
Note:
For older versions the SuperUser account is disabled until you setup the password. 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.

In version >=1.2.4 the SuperUser password is generated automatically on the first server start. You can find it in the logfile. Search for an entry like <W>2013-09-03 11:23:44.516 1 => Password for 'SuperUser' set to 'supersecretpassword'. You can of course change this password.

To set/change the password on the Linux static server, run

murmur.x86 -ini <path to configuration file> -supw <password> [srv]

To set the password on Debian-based systems, run

 # EITHER use the dpkg management facilities
 sudo dpkg-reconfigure mumble-server

 # OR run the server binary manually
 sudo -i murmurd -ini /etc/mumble-server.ini -supw <password> [srv]

To set the password on Windows systems, run

<path to murmur.exe> -ini <path to configuration file> -supw <password> [srv]

Make sure the -ini parameter is the same as for running the server normally to make sure the password gets set in the right database file. If the command does not seem to work, double-check that you are supplying the right path.

The [srv] parameter is the ID of the virtual Mumble-Server you want to change password for. If omitted, ID 1 is used (for the first virtual server).

This will only set the password and then terminate, it will not start the server. To run the server, start it without the -supw parameter.

Starting Murmur

To start Murmur,

On a static Linux build, cd to the directory where you extracted the files and do

murmur.x86

On Debian-based,

sudo dpkg-reconfigure mumble-server

On Windows,

<path to murmur.exe> (usually C:\Program Files\Mumble\Murmur.exe)

For debugging or real time logging, you might want to add -fg -v to the command line, which will stop the program from running in the background.

By default, Murmur opens its 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 from the ini file, using their respective parameters.

Advanced Configuration and Administration

To make use of a strong server certificate the users will not have to manually accept, please see Obtaining a Let's Encrypt Murmur Certificate and Obtaining a Comodo Murmur certificate.

Icons oxygen 48x48 actions view-pim-notes.png
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. Also, nearly all of the basic administration tasks can be completed through the client when using > Mumble 1.2.x.

Compatibility With RPC-Interfaces

For full functionality with an RPC interface, Murmur requires either a working DBus daemon or Ice installation that is enabled. We recommend using the Ice interface; DBus is considered deprecated and although it will not be removed in the near future, it is not receiving any new functionality. Once you have Murmur working with the RPC interface, you can install a compatible web interface; see below for possible options.

Authenticating With an External Database/Forum

Ice

For phpBB3, there is phpBB3auth. You must point the python script to the ini file; read the in-source documentation for more infomation.

For SMF (Simple Machines Forum), there is smfauth. You must point the python script to the ini file; read the in-source documentation for more infomation.

DBus

There is an extended example of how to use the authenticator called scripts/dbusauth.pl. You'll need to configure where your phpBB3 database resides, but once that is done you'll simply have to run the script after starting murmur to allow authentication to be done through the phpBB3 database.

Any group associations the user has on phpBB3 is copied to a temporary group on a root channel (and by default inherited to all subchannels). Please note that this is a temporary group membership and as such will not show up in the Edit ACL dialogs.

3rd Party Applications

If you are planning to administrate your Murmur server with an external 3rd Party Application, see the following pages for further information.

Icons oxygen 48x48 actions view-pim-notes.png
Note:
The aforementioned categories have been moved to the page 3rd Party Applications.

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

Alternative Mumble Servers

There are multiple alternative Mumble Servers which support the Mumble protocol.
Everyone is free to implement their own Mumble server software and add it to this list.

Icons oxygen 48x48 actions view-pim-notes.png
Note:
It is recommended to use the Standard Mumble Server.
These Servers vary in functionality, so check for features and compatibility before use.

Grumble

Grumble is a Mumble Server based on Go (programming language).
It is in active development by the official Mumble team.
Take a look at the Github Repo: https://github.com/mumble-voip/grumble

Icons oxygen 48x48 actions view-pim-notes.png
Note:
For now Grumble lacks support for some features (e.g. remote control, config system).
See https://github.com/mumble-voip/grumble#project-status for more details.

uMurmur

Icons oxygen 48x48 actions view-pim-notes.png
Note:
uMurmur is outdated (last updated: 2017). So it is not recommended for use and might not be compatible with recent versions of Mumble.

uMurmur is a minimalistic Murmur implementation without dependency on QT-core. It lacks features of the Mumble server, but aims at working well on embedded devices like routers.

Read more at the uMurmur project page.