Difference between revisions of "Configuring Murmur"

From Mumble Wiki
Jump to: navigation, search
m (Reverted edit of NodroNgetl, changed back to last version by Slicer)
(Ini file)
Line 3: Line 3:
  
  
== Ini file ==
+
== INI file ==
The server configuration is done through the '''murmur.ini''' file. Here's an example file:
+
The server configuration is done through the '''murmur.ini''' file. It is read using the <code>MetaParams::read()</code> function in [http://mumble.svn.sourceforge.net/viewvc/mumble/trunk/src/murmur/Meta.cpp?view=markup Meta.cpp]. The function's source code will show all the available INI property names in the event new setting are added and this page does not get updated.
 +
 
 +
Here's an example file:
  
 
<pre>
 
<pre>
Line 10: Line 12:
 
welcometext="<br />Welcome to this server running <b>Murmur</b>.<br />Enjoy your stay!<br />"
 
welcometext="<br />Welcome to this server running <b>Murmur</b>.<br />Enjoy your stay!<br />"
  
# Port to bind TCP and UDP sockets to
+
# Port to bind TCP and UDP sockets to.
 
port=64738
 
port=64738
  
Line 51: Line 53:
 
# Murmur default to logging to murmur.log. If you leave this blank,
 
# Murmur default to logging to murmur.log. If you leave this blank,
 
# murmur will log to the console (linux) or through message boxes (win32).
 
# murmur will log to the console (linux) or through message boxes (win32).
 +
# System log file locations:
 +
#  For Windows: logfile=c:\windows\system32\LogFiles\murmur.log
 +
#  For Linux: logfile=/var/log/murmur.log
 
logfile=murmur.log
 
logfile=murmur.log
  
Line 61: Line 66:
 
#registerPassword=secret
 
#registerPassword=secret
 
#registerUrl=http://mumble.sourceforge.net/
 
#registerUrl=http://mumble.sourceforge.net/
 +
 +
# Specifies autoban settings.
 +
#autobanAttempts=10
 +
#autobanTimeframe=120
 +
#autobanTime=300
 +
 +
# Full path and file name of the PEM encoded server identity
 +
# certificate and private key file for SSL.
 +
#sslCert=
 +
#sslKey=
  
 
</pre>
 
</pre>
 
Is pretty self-explanatory.
 
  
 
== Using an external database ==
 
== Using an external database ==

Revision as of 02:39, 13 November 2007

Murmur (A.K.A. mumble server)

INI file

The server configuration is done through the murmur.ini file. It is read using the MetaParams::read() function in Meta.cpp. The function's source code will show all the available INI property names in the event new setting are added and this page does not get updated.

Here's an example file:

# Welcome message sent to users
welcometext="<br />Welcome to this server running <b>Murmur</b>.<br />Enjoy your stay!<br />"

# Port to bind TCP and UDP sockets to.
port=64738

# Password to join server
serverpassword=

# Maximum number of concurrent clients allowed.
users=50

# Maximum bandwidth (in bytes per second) clients are allowed
# send speech at.
bandwidth=5000

# Users hear themselves? (Testmode)
loop=false

# Path to database. If blank, will search for
# murmur.sqlite in default locations.
database=

# How often should commands from the database be checked?
# The default is every 10 seconds. Unless you're writing your
# own scripts, don't bother with this.
commandtime=1

# If you wish to use something other than SQLite, you'll need to set the name
# of the database above, and also uncomment the below.
#
#dbDriver=QMYSQL
#dbUsername=
#dbPassword=
#dbHost=
#dbPort=

# Murmur defaults to not using D-Bus. If you wish to use dbus, please
# specify so here.
#
#dbus=session

# Murmur default to logging to murmur.log. If you leave this blank,
# murmur will log to the console (linux) or through message boxes (win32).
# System log file locations:
#   For Windows: logfile=c:\windows\system32\LogFiles\murmur.log
#   For Linux: logfile=/var/log/murmur.log
logfile=murmur.log

# To enable public registration, the serverpassword must be blank, and this
# must all be filled out.
# The password here is used to create a registry for the server name; subsequent
# updates will need the same password. Don't loose your password.
# The URL is your own website.
#registerName=Mumble Server
#registerPassword=secret
#registerUrl=http://mumble.sourceforge.net/

# Specifies autoban settings.
#autobanAttempts=10
#autobanTimeframe=120
#autobanTime=300

# Full path and file name of the PEM encoded server identity 
# certificate and private key file for SSL.
#sslCert=
#sslKey=

Using an external database

It is possible to use an external database instead of SQLite: