Difference between revisions of "Installing Mumble"

From Mumble Wiki
Jump to: navigation, search
(Windows)
(Android: add unmaintained notice for Plumble)
(116 intermediate revisions by 23 users not shown)
Line 1: Line 1:
=Getting and Installing Mumble=
+
This page shows you directions on how to install and use Mumble (client) and Murmur (server). For complete usage information, see [[Mumbleguide|Mumbleguide]], [[Murmurguide|Murmurguide]], and/or the respective subsections on the main page.
This page shows you directions on how to install Mumble (client) as well as Murmur (server).
 
  
==Windows==
+
__TOC__
  
'''Client'''
+
=Getting and Installing Mumble and Murmur=
  
Just head to [http://sourceforge.net/project/showfiles.php?group_id=147372 SourceForge downloads page], get the Windows executable and run it. Follow the installer instructions and you are done.
+
==Windows==
  
'''Server'''
+
Download and run the latest MSI installer (mumble-1.x.x.msi) from the [https://github.com/mumble-voip/mumble/releases GitHub releases page]. The installer will guide you through installation and configuration of Mumble. This installer can also optionally install Murmur (Mumble server).
  
The server binaries are included in the Mumble installer. In the latest snapshots of Mumble, one now has the ability to only install Murmur.
+
For Win2000 see [[Tips_Tricks#Installation_of_the_Mumble_client_on_Windows_2000|Tips Tricks]]
  
Also, you can build Mumble yourself from source as described in [[BuildingWindows]].
+
==Mac OS X==
 
 
==Linux==
 
Some Linux distributions already have Mumble packaged so that an easy installation is possible. Check your package manager of your distribution for Mumble. But sometimes those packages are not up to date. So if you want more in-depth information about installing Mumble for Linux read up on [[BuildingLinux]]. Installation from source (svn and tarball) is  described there.
 
  
 +
'''Precompiled Mac OS X universal binaries''' are available from the [https://github.com/mumble-voip/mumble/releases GitHub releases page].
  
=== Debian ===
+
Note that the official releases of Mumble 1.2.x are ''not currently compatible with Mac OS X 10.4'', but you can try the experimental snapshots found [http://www.scorpius-project.org/mumble-osx-10.4/ here] '''warning: use at your own risk; these have not been thoroughly tested, and may have bugs'''.
<hr/>
 
====Lenny====
 
Debian Testing (lenny) includes the latest official Mumble packages, and is the officially maintained version. New packaging efforts are encouraged to base their file layout and usernames on what is used here, to make third-party packages easier to port. To install:
 
  
'''Client'''
+
In order to be able to use the '''[[Overlay]]''' it has to be installed separately. To install it launch Mumble, go into ''Mumbles settings'' into the Overlay section and you should see an ''option to install it''. The reason for the separate installation is that Mumble itself does not need administrative rights to install, but the overlay does.
sudo aptitude install mumble
 
  
 +
==Linux==
  
'''Server and web applications'''
+
For most Linux distributions, the client package name is ''mumble'' and the server package name is ''mumble-server'' or ''murmur''. For many Debian- and RPM-based distributions, there is ''mumble-server-web'', which is a turnkey installation of ICE for Murmur.
sudo aptitude install mumble-server mumble-server-web
 
sudo dpkg-reconfigure mumble-server
 
  
''People who are connected to your Mumble server can go to <nowiki>http://</nowiki><your IP or domain>/mumble/register.cgi to register with the server through a web interface.
+
On the popular Linux distributions, Mumble should be available in either third party repositories or the official repository. See the distribution sections below. It is also recommended, if you have a domain name, to use a trusted CA's certificate with your Mumble server, for example see [[Obtaining_a_Let's_Encrypt_Murmur_Certificate|this]] short guide about using Let's Encrypt.
''They can also upload a custom texture that will be displayed in the Mumble game overlay from this page.
 
''Any 600x60 PNG image will work, but if you have an alpha channel on in, it will have transparency.
 
''<nowiki>http://</nowiki><your IP or domain>/mumble/ shows the list of users in your Mumble server.
 
  
Mumble v1.1.6-x86 for Debian Stable ('Etch', 4.0r5) is available at http://Vocis.K1T.NET/
+
==== Debian ====
<hr/>
+
{{Warning
====Etch====
+
|message=Note that with the ''mumble-server'' package on Debian or Debian-based distributions, you should not start the server manually. After you install and configure it, it will start on its own.
Below are guidelines how to run murmur (so its just a server) on Etch release, but its not a completely described solution.
+
}}
 +
Debian ''unstable'' has the latest release at all times in it's repository. Backports to current stable are done as soon as the package reaches ''testing'' (usually a week after release).
  
Requirements:
+
'''Mumble'''
* sudo or su, ability to compile applications from source.
+
apt-get install mumble
* already configured apache2 with php5
+
'''Murmur'''
* mumble static with Ice support
+
apt-get install mumble-server
* some spare time
+
dpkg-reconfigure mumble-server
  
First we gonna get some packages needed to install Ice and IcePHP:
+
==== Ubuntu ====
apt-get install libdb4.4-dev
 
apt-get install pkg-congig
 
apt-get install libbz2-dev
 
  
Let's keep stuff in the single directory, enter it:
+
Ubuntu carries whatever Mumble version was current at the time of the release in the universe repository. We also maintain a [https://launchpad.net/~mumble/+archive/release PPA] ([https://launchpad.net/~mumble/+archive/release stable] and [https://launchpad.net/~mumble/+archive/snapshot dev snapshots]) that has the latest version for recent Ubuntu versions
mkdir ~/src
 
cd ~/src
 
  
Now we download sources of Ice and IcePHP 3.2.0 version:
+
  sudo add-apt-repository ppa:mumble/release
  wget http://www.zeroc.com/download/Ice/3.2/Ice-3.2.0.tar.gz
+
  sudo apt-get update
  wget http://www.zeroc.com/download/Ice/3.2/IcePHP-3.2.0.tar.gz
 
  
Unpack it:
+
To install the client you can use:
tar zxf Ice-3.2.0.tar.gz
 
tar zxf IcePHP-3.2.0.tar.gz
 
  
And then compile Ice:
+
  sudo apt-get install mumble
  cd Ice-3.2.0
 
make
 
  
If the compilation returns error then see the console for the information, probably you will need some extra packages with sources. Google a lot.
+
to install and configure the server use:
  
If compilation is successful then test the build.
+
  sudo apt-get install mumble-server
  make test
+
  sudo dpkg-reconfigure mumble-server
 
 
If everything is ok then install it:
 
make install
 
 
 
By default it will install in /opt/Ice-3.2.0
 
 
 
Now time to compile IcePHP
 
cd ..
 
cd IcePHP-3.2.0
 
  export ICE_HOME=/opt/Ice-3.2.0
 
make
 
make install
 
 
 
In the result you should have the file /opt/IcePHP-3.2.0/lib/IcePHP.so, so copy it to the php5 modules dir - probably something like /usr/lib/php5/20060613+lfs/
 
The ~/src is not used anymore.
 
 
 
Now time to add config to the php5, create file /etc/php5/conf.d/ice.ini and chek the path to the IcePHP.so and the Mumble.ice taken from mumble installation:
 
extension=IcePHP.so
 
ice.slice=/etc/php5/conf.d/Murmur.ice
 
 
 
Reload apache2 and see if the php loaded Ice by pinting your browser to some page with phpinfo().
 
 
 
<hr/>
 
=== Ubuntu ===
 
  
==== Official Repository ====
+
=== RHEL (and its derivatives, such as CentOS) ===
  
'''This is the easy way, but you won't always get the latest version.'''
+
Please see the [[Install CentOS5]] page for both packaged and manual murmur installation instructions. Mumble is not easily built on this platform at this time, and there are no official packages (yet?).
  
Ubuntu Hardy Heron (8.04) includes the Mumble 1.1.x series in it's official repository. It's cloned from Debian testing before every Ubuntu release, so while it will lag slightly behind, it won't be by much. Just follow the directions for installing under Debian.
+
For CentOS 6 see the [[Install CentOS6]] page.
  
==== PPA Repository ====
+
For CentOS 7 see the [[Install CentOS7]] page.
  
'''This is a bit more to type, but should always be up-to-date.'''
+
=== Fedora ===
  
As the packages in the official Ubuntu repository aren't always up-to-date, you can add an external PPA repository to your package manager. It should always include the newest stable version of Mumble and Murmur for i386 and amd64 architectures.
+
Fedora 13-21, use yum:
 +
  yum install mumble
  
You will have to manually add the repositories for the PPA repository. Go to a command prompt and type
+
There are additional packages available as <tt>mumble-*</tt>, such as <tt>mumble-overlay</tt> and <tt>mumble-server-web</tt>. Please consult your package manager for more information.
sudo gedit /etc/apt/sources.list
 
then add the following two lines to the bottom of the file
 
deb http://ppa.launchpad.net/slicer/ubuntu hardy main
 
deb-src http://ppa.launchpad.net/slicer/ubuntu hardy main
 
then run
 
sudo aptitude update
 
(replace ''hardy'' with ''gutsy'' or ''intrepid'' if you are on those distributions)
 
  
Afterward you can use the same command as for installing under Debian (see above).
+
Fedora 22+, use dnf:
 +
  dnf install mumble
  
More information about the PPA repository can be found at [https://launchpad.net/~slicer/+archive/ppa Launchpad]
+
The additional packages are, mumble-overlay, mumble-plugins, murmur.
  
===RPM-based distributions===
+
=== SUSE ===
Fedora, openSUSE, PCLinuxOS, etc. are RPM-based distributions. If their own official package repository doesn't have an up to date version or even no version at all of Mumble, then have a look at openSUSE's Build Service (http://software.opensuse.org).
 
  
There you can find many different RPM-builds for different distributions and architectures of Mumble. '''Note''' that these packages are not officially supported, but it should work.  
+
Mumble packages are available from [http://software.opensuse.org/package/mumble software.opensuse.org].
  
Follow this link to see search results for "mumble": http://software.opensuse.org/search?q=mumble
+
You can follow these steps while running openSUSE:
 +
# Open a web browser and go to [http://software.opensuse.org/package/mumble software.opensuse.org/package/mumble]
 +
# Assuming you're running 32bit, click on '''1-Click Install''' located at the first result
 +
# When asked to download a file, tell your browser you want to open the file
 +
# Once YaST is opened, click ''Next'' (leave defaults), then ''Next'' again, and again
 +
# Enter your root password if asked; Mumble will now download
 +
# Click '''Finish'''
 +
# To run Mumble:
 +
## Open the Kickoff application launcher and type '''mumble''', then --> '''Run mumble'''
 +
## Or: open a terminal and type '''mumble''' and press enter
  
Often you can install it with the RPM tool of your distribution or by typing (as root):
 
rpm -i mumble-1.1.7-i386.rpm
 
  
 +
''Note: If you are asked to accept a certificate just press '''OK'''''
  
 +
''Note: Latest mumble version can usually be found at [http://software.opensuse.org/package/mumble opensuse.org] under "Show other versions" either at "openSUSE Factory" or under "Show unstable packages" of your openSUSE version.''
  
===Gentoo===
+
Some packages can also be found in the [http://download.opensuse.org/repositories/home:/lnussel:/mumble:/unstable/ Build Service].
'''Client'''
 
  
Depending on what other features you want compiled into it, check up on the possible USE-flags: http://www.gentoo-portage.com/media-sound/mumble/USE#ptabs
+
=== Arch Linux ===
 +
To install Mumble, use pacman:
 +
pacman -S mumble
  
It's well possible that the Mumble ebuild is masked by the ~x86, ~amd64, or other keyword. Here, we make sure it will install anyways.
+
For the Mumble Server Murmur:
 +
pacman -S murmur
  
Become root and do:
+
There are also unstable packages  on the AUR:
echo media-sound/mumble >> /etc/portage/package.keywords
+
* Mumble Unstable (updated directly from Git): https://aur.archlinux.org/packages/mumble-git/
emerge -av media-sound/mumble
+
* Murmur Unstable (updated directly from Git): https://aur.archlinux.org/packages/murmur-git/
 +
* Murmur ICE (with ICE support): https://aur.archlinux.org/packages/murmur-ice/
  
To build out of git, use this ebuild:
+
=== Mandriva/ROSA/Unity ===
# Copyright 1999-2009 Gentoo Foundation
 
# Distributed under the terms of the GNU General Public License v2
 
 
EAPI="2"
 
 
inherit eutils multilib qt4 git
 
 
DESCRIPTION="Voice chat software for gaming written in Qt4."
 
HOMEPAGE="http://mumble.sourceforge.net/"
 
EGIT_REPO_URI="git://mumble.git.sourceforge.net/gitroot/mumble"
 
EGIT_PROJECT="mumble"
 
 
LICENSE="BSD"
 
SLOT="0"
 
KEYWORDS="~amd64 ~x86"
 
IUSE="alsa dbus debug g15 oss pch portaudio pulseaudio speech"
 
 
RDEPEND="dev-libs/boost
 
>=media-libs/speex-1.2_beta3_p2
 
x11-libs/qt-core:4[ssl]
 
x11-libs/qt-gui:4
 
x11-libs/qt-opengl:4
 
x11-libs/qt-sql:4[sqlite]
 
alsa? ( media-libs/alsa-lib )
 
dbus? ( x11-libs/qt-dbus:4 )
 
g15? ( app-misc/g15daemon )
 
portaudio? ( media-libs/portaudio )
 
pulseaudio? ( media-sound/pulseaudio )
 
speech? ( app-accessibility/speech-dispatcher )"
 
 
DEPEND="${RDEPEND}"
 
 
src_configure() {
 
local conf_add
 
 
if has_version '<=sys-devel/gcc-4.2'; then
 
conf_add="${conf_add} no-pch"
 
else
 
use pch || conf_add="${conf_add} no-pch"
 
fi
 
 
use alsa || conf_add="${conf_add} no-alsa"
 
use dbus || conf_add="${conf_add} no-dbus"
 
use debug && conf_add="${conf_add} symbols debug" || conf_add="${conf_add} release"
 
use g15 || conf_add="${conf_add} no-g15"
 
use oss || conf_add="${conf_add} no-oss"
 
use portaudio || conf_add="${conf_add} no-portaudio"
 
use pulseaudio || conf_add="${conf_add} no-pulseaudio"
 
use speech || conf_add="${conf_add} no-speechd"
 
 
eqmake4 "${S}/main.pro" -recursive \
 
CONFIG+="${conf_add} no-bundled-speex no-embed-qt-translations no-server no-xevie" \
 
DEFINES+="PLUGIN_PATH=/usr/$(get_libdir)/mumble" \
 
|| die "eqmake4 failed."
 
}
 
 
src_install() {
 
newdoc README.Linux README || die "Installing docs failed."
 
dodoc CHANGES || die "Installing docs failed."
 
 
local dir
 
if use debug; then
 
dir=debug
 
else
 
dir=release
 
fi
 
 
dobin "${dir}"/mumble || die "Installing mumble binary failed."
 
 
CONF_LIBDIR="$(get_libdir)/mumble" dolib.so "${dir}"/lib*.so* || die "Installing libraries failed."
 
CONF_LIBDIR="$(get_libdir)/mumble" dolib.so "${dir}"/plugins/lib*.so* || die "Installing libraries failed."
 
 
insinto /usr/share/services
 
doins scripts/mumble.protocol || die "Installing mumble.protocol file failed."
 
 
dobin scripts/mumble-overlay || die "Installing overlay script failed."
 
 
newicon icons/mumble.64x64.png mumble.png || die "Installing icon failed."
 
 
make_desktop_entry ${PN} "Mumble" mumble "Qt;KDE;Network;Telephony;" \
 
|| die "Installing menu entry failed."
 
 
doman man/mumble-overlay.1 || die "Installing mumble-overlay manpage failed."
 
doman man/mumble.1 || die "Installing mumble manpage failed."
 
}
 
 
pkg_postinst() {
 
echo
 
elog "Visit http://mumble.sourceforge.net/Audio_Tuning for futher configuration."
 
elog "Run mumble-overlay to start the OpenGL overlay (after starting mumble)."
 
echo
 
}
 
  
'''Server'''
+
Mumble is available since 2010.0.
  
Depending on what other features you want compiled into it, check up on the possible USE-flags: http://www.gentoo-portage.com/media-sound/murmur/USE#ptabs
+
urpmi mumble
  
It's well possible that the Murmur ebuild is masked by the ~x86, ~amd64, or other keyword. Here, we make sure it will install anyways.
+
It's best to install the package from Cooker - it has many fixes.
  
Become root and do:
+
=== Others ===
echo media-sound/murmur >> /etc/portage/package.keywords
 
emerge -av media-sound/murmur
 
  
To build out of git, use this ebuild:
+
If all of the above options fail to work, you can always try [[BuildingLinux|compiling Mumble from source]], however installing a package is considered "best practice".
# Copyright 1999-2009 Gentoo Foundation
 
# Distributed under the terms of the GNU General Public License v2
 
 
EAPI="2"
 
 
inherit eutils qt4 git
 
 
MY_PN="mumble"
 
MY_P=${MY_PN}-${PV}
 
 
DESCRIPTION="Voice chat software for gaming written in Qt4 (server)."
 
HOMEPAGE="http://mumble.sourceforge.net/"
 
EGIT_REPO_URI="git://mumble.git.sourceforge.net/gitroot/mumble"
 
EGIT_PROJECT="mumble"
 
 
LICENSE="BSD"
 
SLOT="0"
 
KEYWORDS="~amd64 ~x86 ~ia64"
 
IUSE="debug +ice logrotate pch"
 
 
RDEPEND="
 
x11-libs/qt-core:4[ssl]
 
x11-libs/qt-dbus:4
 
|| ( x11-libs/qt-sql:4[sqlite] x11-libs/qt-sql:4[mysql] )
 
ice? ( dev-cpp/Ice dev-libs/boost )
 
logrotate? ( app-admin/logrotate )
 
"
 
 
DEPEND="${RDEPEND}"
 
 
S="${WORKDIR}"/${MY_P}
 
 
pkg_setup() {
 
enewgroup murmur
 
enewuser murmur -1 -1 /var/lib/murmur murmur
 
}
 
 
src_prepare() {
 
sed -i \
 
-e 's:mumble-server:murmur:g' \
 
scripts/murmur.conf \
 
scripts/murmur.ini.system \
 
|| die "sed failed."
 
}
 
 
src_configure() {
 
local conf_add
 
use debug && conf_add="${conf_add} symbols debug" || conf_add="${conf_add} release"
 
use ice || conf_add="${conf_add} no-ice"
 
use pch || conf_add="${conf_add} no-pch"
 
 
eqmake4 main.pro -recursive \
 
CONFIG+="${conf_add} no-client no-bundled-speex" \
 
|| die "eqmake4 failed."
 
}
 
 
src_install() {
 
dodoc README CHANGES || die "Installing docs failed."
 
 
docinto scripts
 
dodoc scripts/*.php scripts/*.pl || die "Installing docs failed."
 
 
local dir
 
if use debug; then
 
dir=debug
 
else
 
dir=release
 
fi
 
 
dobin "${dir}"/murmurd || die "Installing murmurd binary failed."
 
 
insinto /etc/murmur/
 
newins scripts/murmur.ini.system murmur.ini || die "Installing murmur.ini configuration file failed."
 
 
if use logrotate; then
 
insinto /etc/logrotate.d/
 
newins "${FILESDIR}"/murmur.logrotate murmur || die "Installing murmur logrotate file failed."
 
fi
 
 
insinto /etc/dbus-1/system.d/
 
doins scripts/murmur.conf || die "Installing murmur.conf dbus configuration file failed."
 
 
newinitd "${FILESDIR}"/murmur.initd murmur || die "Installing murmur init.d file failed."
 
newconfd "${FILESDIR}"/murmur.confd murmur || die "Installing murmur conf.d file failed."
 
 
keepdir /var/lib/murmur /var/run/murmur /var/log/murmur
 
fowners -R murmur /var/lib/murmur /var/run/murmur /var/log/murmur || die "fowners failed."
 
fperms 750 /var/lib/murmur /var/run/murmur /var/log/murmur || die "fperms failed."
 
 
doman man/murmurd.1 || die "Installing murmur manpage failed."
 
}
 
 
pkg_postinst() {
 
echo
 
elog "Useful scripts are located in /usr/share/doc/${PF}/scripts."
 
elog "Please execute:"
 
elog "murmurd -ini /etc/murmur/murmur.ini -supw <pw>"
 
elog "chown murmur:murmur /var/lib/murmur/murmur.sqlite"
 
elog "to set the inbuild 'SuperUser' password before starting murmur."
 
elog "Please restart dbus before starting murmur,"
 
elog "or dbus registration will fail."
 
echo
 
}
 
  
===ArchLinux===
+
== Smartphones ==
A  stable PKGBUILD is avalaible in the [http://aur.archlinux.org/packages.php?do_Details=1&ID=10221&K=mumble AUR]. Download the tarball and then run:
+
Mumble is currently being ported/reimplemented for various mobile phone platforms.
tar xzfv mumble*.tar.gz
 
cd mumble*
 
makepkg
 
  
That should create a package for you. Of course, you need to install all the dependencies listed before. To do it in a single command:
+
=== Android ===
 
+
Plumble is an unofficial client made by Morlunk. It is '''unmaintained'''.
pacman -S alsa-lib qt4 libxevie sqlite3 boost
 
 
 
Finally, install the package:
 
 
 
pacman -A mumble-1.0.0-1.pkg.tar.gz
 
 
 
Of course, replace the package name as appropriate.
 
 
 
If you want to test a SVN Snapshoth, use this [http://aur.archlinux.org/packages.php?ID=23369 PKGBUILD] in the [http://aur.archlinux.org/packages.php?ID=23369 AUR]. Use [http://wiki.archlinux.org/index.php/Yaourt Yaourt] or the instructions above.
 
 
 
==Mac OS X==
 
 
 
Precompiled Mac OS X universal binaries are available from the [http://sourceforge.net/project/showfiles.php?group_id=147372 SourceForge downloads page].
 
 
 
You can also build it from source yourself if you wish. See [[BuildingMacOSX]] for more information.
 
 
 
==Snapshots==
 
 
 
If you want to get the latest snapshots for Mumble and Murmur, you can find those [http://mumble.info/snapshot/ here]. These include the latest builds of Mumble and Murmur for Windows, and static builds of Murmur for Linux.
 
 
 
=Post-installation tips=
 
==Common tips==
 
===Initializing/Resetting Murmur SuperUser password===
 
Type:
 
murmur -supw <password>
 
That will change the password for SuperUser, a special user that has all rights.
 
If you want to reset the entire database, just delete murmur.sqlite and the recreate it with the command above.
 
 
 
==Windows==
 
===Text-to-Speech===
 
The Text-To-Speech voices that ship by default with Windows are not all that good (and if you are not English, its even worse as it will try to speak english even when the text is not). If you have installed either MS Office or the Speech SDK, you will get more voices which can be configured from the Speech control panel. You can also buy a commercial Text-To-Speech engine; as long as it's SAPI5 compatible it can be used by Mumble. The main developers are currently using NeoSpeech Kate (buyable standalone from [http://www.nextup.com NextUp]).
 
 
 
===Creating a server connection shortcut===
 
You can right click on your desktop and choose "New" and pick "Shortcut" from the sub-menu.
 
In the box that says "Type the location of the item" put "mumble://username:password@servername/channel"
 
replacing the "username" with the name you log into the murmur server with (or omitting it and mumble will ask you for a user name), replacing "servername" with the DNS name or IP address of the murmur server.  "Channel" may be omitted if you want to connect to the root channel.  If a password is not specified mumble will request one from you when it attempts to connect.  The bare minimum required for the shortcut would be "mumble://servername" with mumble requesting a username and a password upon attempting to connect to "servername".  This format would also be used to embed a link to your murmur server in a web page, perhaps in the members section of a clan home page.
 
 
 
===It complains about mumble_ol.dll / Problems with Overlay===
 
If you are running XP you will need to update it to SP2.
 
 
 
=== Murmur dies when I log out! How can I get Murmur to stay on all the time? ===
 
If you've noticed that the Murmur server dies when you log out of Windows, this is expected. If you want Murmur to run all the time, it'll need to be ran as a service. Fortunately, this is really easy to do! For the purposes of this write-up, the service we are creating is Murmur Demo. You may call it something else if you so choose.
 
 
 
Some references you'll see int his write-up:
 
 
 
instsrv.exe - A program that adds services to the Windows registry.
 
 
 
srvany.exe - A program that allows any Windows application and some Windows 16-bit applications to run as a service.
 
 
 
'''The HOW-TO'''
 
 
 
Step 1: Gain Administrator access on the machine running Murmur.
 
 
 
Step 2: Download and install the following collection of tools from Microsoft to the default directory (C:\Program Files\Windows Resource Kits):
 
 
 
[http://www.microsoft.com/downloads/details.aspx?FamilyID=9d467a69-57ff-4ae7-96ee-b18c4790cffd&displaylang=en Windows 2003 Server Resource Kit].
 
 
 
Step 3: Open a command console (Start >> Accessories >> Command Prompt).
 
 
 
Step 4: If you have installed to the default directory, type the following:
 
 
 
"C:\Program Files\Windows Resource Kits\Tools\instsrv.exe" "Murmur" "C:\Program Files\Windows Resource Kits\Tools\srvany.exe"
 
 
 
The result of this step is a new service in the Services console (Start >> Control Panel >> Administrative Tools >> Services).
 
 
 
'''Be sure to close the Services console before proceeding.'''
 
 
 
Step 5: Open the registry editor (Start >> Run and enter "regedit") and navigate to the following key:
 
 
 
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Murmur Demo
 
 
 
 
 
Step 6: Right click on the key name ("Murmur Demo") in the left panel of regedit, and from the menu that pops up, select New >> Key.
 
 
 
Step 7: Name this new key "Parameters"
 
 
 
Step 8: Right click on the key name ("Parameters") in the left panel of regedit, and from the menu that pops up, select New >> String value.
 
 
 
Step 9: Name this new String value "Application".
 
 
 
Step 10: Right click on the String value ("Application) in the right panel of regedit, and from the menu that pops up, select Modify. Change the value from blank to the full path to your murmur.exe file.
 
 
 
Repeat steps 8 through 10, making a second String value called "AppDirectory" and set its value to the full directory path of your murmur.exe file.
 
 
 
Step 11: Close Regedit
 
 
 
Step 12: Open the Services console. Navigate to your service, and right click it and select Properties.
 
 
 
Step 13: Make sure the Startup Type value is Automatic, and then press the Start button.
 
 
 
At this point, the server should launch, although you probably won't see it. You can test to see if it's working by trying to connect to it using your client.
 
 
 
If your server did start, congratulations, you're done. You should be able to logoff and reboot the machine if you want, with Murmur pesisting through both.
 
 
 
If your server did not start, recheck your settings. Most problems are related to typos in configuration settings.
 
 
 
==Linux==
 
===Getting the Shortcuts Suppression to work===
 
  
You need to have Xevie enabled in your xorg.conf. To do this you will have to add the following line to xorg.conf, in the extensions section:
+
It has many features in addition to the Mumble's ones, such as: bluetooth headset support, proximity sensor utilizing "Voice Call" mode and hardware push-to-talk key support.
  
Option        "XEVIE" "Enable"
+
You can download it on [https://play.google.com/store/apps/details?id=com.morlunk.mumbleclient.free Google Play] or [https://f-droid.org/repository/browse/?fdid=com.morlunk.mumbleclient F-Droid].
  
That should like something like this:
+
=== iPhone ===
 +
The Mumble iOS client is available [https://itunes.apple.com/us/app/mumble/id443472808?mt=8 on the App Store].
  
Section "Extensions"
+
You can find more information about the iOS client from the [https://github.com/mumble-voip/mumble-iphoneos mumble-iphoneos GitHub repo]. Any help with the project is always appreciated.
    ...
 
    Option        "XEVIE" "Enable"
 
    ...
 
EndSection
 
  
Then restart the X server (Ctrl+Alt+Backspace) and try again.
+
=== Maemo (Nokia) ===
 +
Maemo builds can be found [http://maemo.org/packages/view/mumble/ here]. These builds are unsupported, as they were not made by official Mumble developers. That does not, of course, mean you shouldn't use them; it just means there's no guarantee we can help you if you have a problem.
  
[[Category:Documentation]]
 
 
[[Category:Documentation English]]
 
[[Category:Documentation English]]

Revision as of 16:49, 27 October 2019

This page shows you directions on how to install and use Mumble (client) and Murmur (server). For complete usage information, see Mumbleguide, Murmurguide, and/or the respective subsections on the main page.

Getting and Installing Mumble and Murmur

Windows

Download and run the latest MSI installer (mumble-1.x.x.msi) from the GitHub releases page. The installer will guide you through installation and configuration of Mumble. This installer can also optionally install Murmur (Mumble server).

For Win2000 see Tips Tricks

Mac OS X

Precompiled Mac OS X universal binaries are available from the GitHub releases page.

Note that the official releases of Mumble 1.2.x are not currently compatible with Mac OS X 10.4, but you can try the experimental snapshots found here warning: use at your own risk; these have not been thoroughly tested, and may have bugs.

In order to be able to use the Overlay it has to be installed separately. To install it launch Mumble, go into Mumbles settings into the Overlay section and you should see an option to install it. The reason for the separate installation is that Mumble itself does not need administrative rights to install, but the overlay does.

Linux

For most Linux distributions, the client package name is mumble and the server package name is mumble-server or murmur. For many Debian- and RPM-based distributions, there is mumble-server-web, which is a turnkey installation of ICE for Murmur.

On the popular Linux distributions, Mumble should be available in either third party repositories or the official repository. See the distribution sections below. It is also recommended, if you have a domain name, to use a trusted CA's certificate with your Mumble server, for example see this short guide about using Let's Encrypt.

Debian

Icons oxygen 48x48 status task-attention.png
Warning: Note that with the mumble-server package on Debian or Debian-based distributions, you should not start the server manually. After you install and configure it, it will start on its own.

Debian unstable has the latest release at all times in it's repository. Backports to current stable are done as soon as the package reaches testing (usually a week after release).

Mumble

apt-get install mumble

Murmur

apt-get install mumble-server
dpkg-reconfigure mumble-server

Ubuntu

Ubuntu carries whatever Mumble version was current at the time of the release in the universe repository. We also maintain a PPA (stable and dev snapshots) that has the latest version for recent Ubuntu versions

sudo add-apt-repository ppa:mumble/release
sudo apt-get update

To install the client you can use:

sudo apt-get install mumble

to install and configure the server use:

sudo apt-get install mumble-server
sudo dpkg-reconfigure mumble-server

RHEL (and its derivatives, such as CentOS)

Please see the Install CentOS5 page for both packaged and manual murmur installation instructions. Mumble is not easily built on this platform at this time, and there are no official packages (yet?).

For CentOS 6 see the Install CentOS6 page.

For CentOS 7 see the Install CentOS7 page.

Fedora

Fedora 13-21, use yum:

 yum install mumble

There are additional packages available as mumble-*, such as mumble-overlay and mumble-server-web. Please consult your package manager for more information.

Fedora 22+, use dnf:

 dnf install mumble

The additional packages are, mumble-overlay, mumble-plugins, murmur.

SUSE

Mumble packages are available from software.opensuse.org.

You can follow these steps while running openSUSE:

  1. Open a web browser and go to software.opensuse.org/package/mumble
  2. Assuming you're running 32bit, click on 1-Click Install located at the first result
  3. When asked to download a file, tell your browser you want to open the file
  4. Once YaST is opened, click Next (leave defaults), then Next again, and again
  5. Enter your root password if asked; Mumble will now download
  6. Click Finish
  7. To run Mumble:
    1. Open the Kickoff application launcher and type mumble, then --> Run mumble
    2. Or: open a terminal and type mumble and press enter


Note: If you are asked to accept a certificate just press OK

Note: Latest mumble version can usually be found at opensuse.org under "Show other versions" either at "openSUSE Factory" or under "Show unstable packages" of your openSUSE version.

Some packages can also be found in the Build Service.

Arch Linux

To install Mumble, use pacman:

pacman -S mumble

For the Mumble Server Murmur:

pacman -S murmur

There are also unstable packages on the AUR:

Mandriva/ROSA/Unity

Mumble is available since 2010.0.

urpmi mumble

It's best to install the package from Cooker - it has many fixes.

Others

If all of the above options fail to work, you can always try compiling Mumble from source, however installing a package is considered "best practice".

Smartphones

Mumble is currently being ported/reimplemented for various mobile phone platforms.

Android

Plumble is an unofficial client made by Morlunk. It is unmaintained.

It has many features in addition to the Mumble's ones, such as: bluetooth headset support, proximity sensor utilizing "Voice Call" mode and hardware push-to-talk key support.

You can download it on Google Play or F-Droid.

iPhone

The Mumble iOS client is available on the App Store.

You can find more information about the iOS client from the mumble-iphoneos GitHub repo. Any help with the project is always appreciated.

Maemo (Nokia)

Maemo builds can be found here. These builds are unsupported, as they were not made by official Mumble developers. That does not, of course, mean you shouldn't use them; it just means there's no guarantee we can help you if you have a problem.