Sunday, March 2, 2008

How to setup Mumble Server on Ubuntu

This guide was created to assist in the setting up of Murmur on Ubuntu 7.10. Murmur is the server for the program Mumble. Mumble is an open source, low-latency, high quality voice chat software primarily intended for use while gaming.

This guide has no warranty and is not guaranteed to work in all situations, it just gives the basic on how to get Murmur up and running.

Get and Install Murmur (A.K.A. Mumble Server):

So, first off, you must get Murmur installed. Currently in Ubuntu 7.10, Murmur is not in the repository but a Debian package is given so we will use that. The version at the time of writing this is 1.1.3. To download the most recent click here. Otherwise, follow these steps to download 1.1.3.
 cd /tmp
 wget http://downloads.sourceforge.net/mumble/mumble-server_1.1.3-0ubuntu1_i386.deb?modtime=1203796511&big_mirror=0
 dpkg -i mumble-server_1.1.3-0ubuntu1_i386.deb

Configuring Murmur:

The server configuration is done through the murmur.ini file. Go to the Mumble homepage to view the example file.

To change any of the default settings you must edit the mumble-server.ini file. This file is well documented and fairly self-explanatory.
 gedit /etc/mumble-server.ini
The default port for murmur is 64738. You will need to open this port, or whichever port you changed this too, in the firewall. If you are running a GUI you can install firestarter to open the necessary ports.
 sudo apt-get install firestarter
Note: If you aren't running the GUI then you'll have to manually edit the iptables to open the port.

Create the Database and Users:

Our first step is to setup the database and create the password for the mumble-superuser ( "SuperUser" ). Running this command will create the database in the current directory and create the superuser user in the database.
 sudo mkdir /etc/murmur
 cd /etc/murmur
 murmurd -supw %password%
Now that the database is created and the super user is created, we can start adding more users. To do this go to Mumble website to download the needed script.
 firefox
 navigate to http://mumble.sourceforge.net/Running_Murmur
 copy the script
 cd /etc/murmur
 gedit config.sh
 paste script
 save and close
This script must be ran from the same directory that the database is in. So make sure to save it where ever that may be.

Once the script is in the same directory as the database, then you're ready to add some users. To add users, it requires 4 things. The first is the name, then password followed by the server number and the email address.

This is very simple. Just run this command replacing the content with your own:
 cd /etc/murmur
 ./config.sh adduser bob test1234 1 bob@gmail.com
To get a listing of all the usable command do:
 ./config.sh --help
You can add users, delete users, change there passwords and change email addresses.

Running Murmur:

We have now successfully setup Murmur and are ready to run it. Murmur can take a couple of parameters. One we already used earlier to create the superuser and database. You can also specify the ini file that you want to use as well as run the program in the foreground. To get a complete listing read it in the man pages.

Here is the command to start Murmur using the ini file /etc/mumble-server.ini:
 cd /etc/murmur
 murmurd -ini /etc/mumble-server.ini
This will start the Murmur as a background process.

Congratulations, you now have have a Mumble Server up and running. Enjoy chatting will all of your friends.

Further Reading:

There are more options to Murmur than what I've covered here. If you want further information on what options there are then visit the Mumble homepage and read into the documentation for how to setup these features.

7 comments:

Aeonoris said...

When you say "copy the script" from the Running Mumble page, what do you mean? There are a kazillion scripts on that page...

Joe said...

As a stumbling block, it might be worth documenting you'll get the 'you might need to update using apt-get -f install'. Its a bit obvious but worthwhile adding imho in any case.

Joe said...

The steps with:

*firefox
*navigate to http://mumble.sourceforge.net/Running_Murmur

and just paste a script, is this not something the installer can do?

This is a little bit abortive. I'd like something that installs it, then I can edit a config file, and start the daemon. Just me perhaps, but is it that hard to automate an installation? When I navigated to the page mentioned its a load of scripts, and after a few wines, quite hard to follow through :p

Joe said...

Aborted install, I'd like to try it out but its not 5-second friendly. I like 5-second friendly - some bullet points to install it, configure it and try it - then fine tune it if need be. This didn't meet them. Might be great, might be excellent, but I'll never know because it was too annoying to try. Might be flamage suggesting rtfm etc, but that is beside the point. Spend a few minutes on making the install easy, and you'll get so much more uptake and testers.

Grégoire said...

When I went to the website, for config.sh I didn't find it. Could you help me ?

Mercedes-Benz's Rock said...

The config.sh file was used to create new users in the system and is no longer required. User creation functionality is now built directly into the GUI.

Clearly Talking said...

Thank you very much for this useful information.Please keep on blogging.I am looking forward to read your next great blog.

More information visit our site How Not to Mumble