Difference between revisions of "Installing Mumble"

From Mumble Wiki
Jump to: navigation, search
(Update Mac OS X section.)
m (Download and Install Mumble and Mumble-Server (aka Murmur): drop murmur term)
 
(244 intermediate revisions by 36 users not shown)
Line 1: Line 1:
=Getting and Installing Mumble=
+
__TOC__
 +
 
 +
=Download and Install Mumble and Mumble-Server=
 +
 
 
==Windows==
 
==Windows==
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.
+
'''Mumble:'''<br> 
 +
Download the latest stable version of Mumble from the [https://www.mumble.info/downloads/ Official Website].<br> 
 +
The installer will guide you through the installation and configuration of Mumble.  
  
Also, you can build Mumble yourself from source as described in [[BuildingWindows]].
+
Alternatively you can download and run the latest MSI installer (mumble-1.x.x.msi; "winx64" for the 64-bit version) from the [https://github.com/mumble-voip/mumble/releases GitHub releases page].<br>   
 +
''Note:'' Releases that include the term "RC" are '''R'''elease''' C'''andidates and therefore Test Versions.
 +
 
 +
'''Mumble-Server:'''<br> 
 +
The Mumble-Installer includes an option to install the Mumble-Server.
 +
 
 +
==Mac OS X==
 +
'''Mumble:'''<br>
 +
Download the latest stable version of Mumble from the [https://www.mumble.info/downloads/ Official Website].<br>
  
==Linux==
+
Alternatively you can download the latest version from the: [https://github.com/mumble-voip/mumble/releases GitHub releases page]. <br>   
If you want to compile your own version of Mumble, you can read some help in [[Building_from_Source]].
+
''Note:'' Releases that include the term "RC" are '''R'''elease''' C'''andidates and therefore Test Versions.
  
===Ubuntu ===
+
In order to be able to use the '''[[Overlay]]''' it has to be installed separately. <br>
 +
To install it: launch Mumble, go into ''Mumble's settings'' -> Overlay section and you should see an ''option to install it''.<br>
 +
The reason for the separate installation is that Mumble itself does not need administrative rights to install, but the overlay does.
  
In hardy, the 1.1.X series is included, so just
+
'''Mumble-Server:'''<br>
apt-get install mumble mumble-server
+
You can download a static version of the Mumble-Server from the [https://www.mumble.info/downloads/ Official Website].<br>
  
If you are running gutsy, or want a newer version than what is available in the official repository, you can download the .deb package avalaible at [http://sourceforge.net/project/showfiles.php?group_id=147372 SourceForge] and install it with your package manager.  
+
==Linux==
 +
On the most popular Linux distributions, Mumble should be available in the official repositories or third-party repositories. <br>
 +
For Details, take a look at the distribution-sections below. <br>
 +
If no package is available, take a look at the [[Installing Mumble#Snap_Package_.28for_various_Distributions.29|Snap]]- and [[Installing_Mumble#Flatpak_Package_.28for_various_Distributions.29|Flatpak]]-packages below (which will run on various distributions) or you can try to compile Mumble, see Section: [[Installing_Mumble#Building_Mumble|Building-Mumble]].
  
Alternately you can use the PPA for mumble builds, which can be found at [https://edge.launchpad.net/~slicer/+archive launchpad]. The PPA builds are not signed, but they include builds for both i386 and amd64. Add the PPA to your list of sources, and you can ''apt-get install'' it and it will automatically track new releases of Mumble.
+
==== Debian ====
  
===Fedora===
+
To install Mumble from the Debian Repository, run:
Fedora 7 RPMs: [http://koji.fedoraproject.org/koji/getfile?taskID=227582&name=mumble-1.1.0-1.fc7.i386.rpm 1.1.0 i386] [http://koji.fedoraproject.org/koji/getfile?taskID=227581&name=mumble-1.1.0-1.fc7.x86_64.rpm 1.1.0 x86_64]
 
Fedora 8 RPMs: [http://koji.fedoraproject.org/koji/getfile?taskID=231652&name=mumble-1.1.0-2.fc8.i386.rpm 1.1.0 i386] [http://koji.fedoraproject.org/koji/getfile?taskID=231651&name=mumble-1.1.0-2.fc8.x86_64.rpm 1.1.0 x86_64]
 
  
  Install them via double click.
+
  apt-get install mumble
===PCLinuxOS and other RPM based distros===
 
You can find a rpm package in the [http://sourceforge.net/forum/forum.php?thread_id=1782689&forum_id=492606 forum]. Note that it is not officially supported, but it should work. You can install it with your rpm package manager or typing (as root):
 
  
  rpm -i mumble-1.0.0-2.i386.rpm
+
For the Mumble-Server, run:
 +
  apt-get install mumble-server
  
===Gentoo===
+
{{Notice
emerge mumble
+
|message=The ''mumble-server''-Package on Debian and Debian-based distributions (i.a. Ubuntu) will start automatically on system-start.<br>
That should do it. You will need Qt4 compiled with the sqlite and sqlite3 flags. Note that the ebuild in the repository is a little outdated, you can find newer versions in the [http://sourceforge.net/forum/forum.php?thread_id=1779400&forum_id=492606 forums].
+
You can disable the autostart with systemd.
 +
You find details in the file "README.Debian".
 +
}}
  
===ArchLinux===
+
==== Ubuntu ====
A 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:
 
tar xfv 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:
+
The Ubuntu Repositories include a Mumble version from the time when the Ubuntu Version was released, thus it might be outdated. <br>
 +
We also maintain a [https://launchpad.net/~mumble/+archive/release PPA] ([https://launchpad.net/~mumble/+archive/release stable]) with
 +
the recent versions of Mumble.<br>
 +
If you want to try the latest development version, you can use the: ([https://launchpad.net/~mumble/+archive/snapshot dev snapshots])
  
pacman -S alsa-lib qt4 libxevie sqlite3 boost
+
To add the PPA use:
  
Finally, install the package:
+
sudo add-apt-repository ppa:mumble/release
 +
sudo apt-get update
  
pacman -A mumble-1.0.0-1.pkg.tar.gz
+
To install the client you can use:
  
Of course, replace the package name as appropriate.
+
sudo apt-get install mumble
  
==Mac OS X==
+
to install and configure the server use:
Precompiled Mac OS X universal binaries are available from the SourceForge downloads page.
 
  
You can also build it from source yourself if you wish. See [[BuildingMacOsX]] for more information.
+
sudo apt-get install mumble-server
 +
sudo dpkg-reconfigure mumble-server
  
=Post-installation tips=
+
{{Notice
==Common tips==
+
|message=The ''mumble-server''-Package in Ubuntu will start automatically on system-start.<br>
===Initializing/Resetting Murmur password===
+
You can disable the autostart with systemd.
Type:
+
You find details in the file "README.Debian".
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==
+
=== RHEL (and its derivatives, such as CentOS) ===
===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===
+
Please see the [[Install CentOS5]] page for both packaged and manual Mumble Server installation instructions. Mumble is not easily built on this platform at this time, and there are no official packages (yet?).
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===
+
For CentOS 6 see the [[Install CentOS6]] page.
If you are running XP you will need to update it to SP2. You also need to update to the latest DirectX9 version that can be downloaded from the [http://www.microsoft.com/downloads/details.aspx?FamilyId=2DA43D38-DB71-4C1B-BC6A-9B6652CD92A3&displaylang=en Microsoft site]. The [http://www.microsoft.com/downloads/details.aspx?FamilyID=b406cf67-d926-463b-99e8-27199d6626b5&DisplayLang=en June 2007 version] should be enough.
 
  
=== Murmur dies when I log out! How can I get Murmur to stay on all the time? ===
+
For CentOS 7 see the [[Install CentOS7]] page.
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:
+
=== Fedora ===
  
instsrv.exe - A program that adds services to the Windows registry.
+
Install from Fedora Repositories:
  
srvany.exe - A program that allows any Windows application and some Windows 16-bit applications to run as a service.
+
To install mumble, run:
 +
  dnf install mumble
  
'''The HOW-TO'''
+
For the Mumble-Server, run:
 +
  dnf install murmur
  
Step 1: Gain Administrator access on the machine running Murmur.
+
There are additional packages available for the [[Overlay]] and Plugins:
 +
* mumble-overlay
 +
* mumble-plugins
  
Step 2: Download and install the following collection of tools from Microsoft to the default directory (C:\Program Files\Windows Resource Kits):
+
=== SUSE ===
  
[http://www.microsoft.com/downloads/details.aspx?FamilyID=9d467a69-57ff-4ae7-96ee-b18c4790cffd&displaylang=en Windows 2003 Server Resource Kit].
+
Mumble packages are available from [http://software.opensuse.org/package/mumble software.opensuse.org].
  
Step 3: Open a command console (Start >> Accessories >> Command Prompt).
+
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
  
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"
+
''Note: If you are asked to accept a certificate just press '''OK'''''
  
Below is an example of what you should see:
+
''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.''
  
http://soapbox.sytes.net/Portals/soapbox/Mumble/command.jpg
+
Some packages can also be found in the [http://download.opensuse.org/repositories/home:/lnussel:/mumble:/unstable/ Build Service].
  
The result of this step is a new service in the Services console (Start >> Control Panel >> Administrative Tools >> Services).
+
=== Arch Linux ===
 +
To install Mumble from the Arch Repositories, run:
 +
pacman -S mumble
  
  http://soapbox.sytes.net/Portals/soapbox/Mumble/service.jpg
+
For the Mumble Server (aka Murmur):
 +
  pacman -S murmur
  
'''Be sure to close the Services console before proceeding.'''
+
There are also unstable packages available in the [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR]:
 +
* Mumble Unstable (updated directly from Git): https://aur.archlinux.org/packages/mumble-git/
 +
* Mumble-Server Unstable (updated directly from Git): https://aur.archlinux.org/packages/murmur-git/
  
Step 5: Open the registry editor (Start >> Run and enter "regedit") and navigate to the following key:
+
=== Mandriva/ROSA/Unity ===
  
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Murmur Demo
+
Mumble is available since 2010.0.
  
Regedit should look something like this:
+
urpmi mumble
  
http://soapbox.sytes.net/Portals/soapbox/Mumble/regedit.jpg
+
It's best to install the package from Cooker - it has many fixes.
  
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.
+
=== Snap Package (for various Distributions) ===
  
http://soapbox.sytes.net/Portals/soapbox/Mumble/newkey.jpg
+
An Snap Package is available: https://snapcraft.io/mumble<br>
  
Step 7: Name this new key "Parameters"
+
It is maintained by a third-party: the Snapcrafters.
  
http://soapbox.sytes.net/Portals/soapbox/Mumble/parameters.jpg
+
=== Flatpak Package (for various Distributions) ===
  
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.
+
A Flatpak Package is available: https://www.flathub.org/apps/details/info.mumble.Mumble
  
http://soapbox.sytes.net/Portals/soapbox/Mumble/newstring.jpg
+
=== Building Mumble ===
  
Step 9: Name this new String value "Application".
+
If all of the above options fail to work, you can always try to [[BuildingLinux|compile Mumble from source]], however installing a package is considered "best practice".
  
http://soapbox.sytes.net/Portals/soapbox/Mumble/application.jpg
+
== BSD ==
 +
=== FreeBSD ===
 +
To install Mumble:
  
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.
+
pkg install mumble
  
http://soapbox.sytes.net/Portals/soapbox/Mumble/editapplication.jpg
+
To install Murmur:
  
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. When you're done making your registry changes, your edits should produce something like this:
+
pkg install murmur
  
http://soapbox.sytes.net/Portals/soapbox/Mumble/final.jpg
+
To enable Murmur:
  
Step 11: Close Regedit
+
sysrc murmur_enable="YES"
  
Step 12: Open the Services console. Navigate to your service, and right click it and select Properties.
+
=== OpenBSD ===
 +
To install Mumble:
  
  http://soapbox.sytes.net/Portals/soapbox/Mumble/panel.jpg
+
  pkg_add mumble
  
Step 13: Make sure the Startup Type value is Automatic, and then press the Start button.
+
To install the Mumble-Server (Murmur):
  
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.
+
pkg_add murmur
  
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.
+
To enable Mumble-Server:
  
If your server did not start, recheck your settings. Most problems are related to typos in configuration settings.
+
rcctl enable murmurd
  
==Linux==
+
{{Notice|message=The murmur package became available with the release of OpenBSD 6.7 and doesn't exist in OpenBSD 6.6 and previous releases.}}
===Getting the Shortcuts to work===
 
There are two alternatives:
 
Either use native input or Xevie.
 
  
For native input make sure that the user running Mumble has read permissions on the /dev/input/eventX files of the input devices you want to use for shortcuts.
+
== Smartphones ==
Be aware that too weak permissions may be a security risk, because malicious processes may log all your input.
 
  
If Mumble can not read from any input device it falls back to Xevie.
+
=== Android ===
 +
[[Mumla]] is an unofficial client (by Quite), it's the successor of deprecated Plumble.
  
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 Mumla on [https://f-droid.org/packages/se.lublin.mumla/ F-Droid] and on the [https://play.google.com/store/apps/details?id=se.lublin.mumla Google Playstore].
  
That should like something like this:
+
=== iPhone ===
 +
{{Notice|message=The iOS client is outdated!}}
  
Section "Extensions"
+
The Mumble iOS client is available [https://itunes.apple.com/us/app/mumble/id443472808?mt=8 on the App Store].
    ...
 
    Option        "XEVIE" "Enable"
 
    ...
 
EndSection
 
  
Then restart the X server (Ctrl+Alt+Backspace) and try again.
+
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.
  
===Running murmur as a SysV service===
+
[[Category:Documentation English]]
You can use [[Murmur_Init_Script]].
 

Latest revision as of 08:50, 11 June 2023

Download and Install Mumble and Mumble-Server

Windows

Mumble:
Download the latest stable version of Mumble from the Official Website.
The installer will guide you through the installation and configuration of Mumble.

Alternatively you can download and run the latest MSI installer (mumble-1.x.x.msi; "winx64" for the 64-bit version) from the GitHub releases page.
Note: Releases that include the term "RC" are Release Candidates and therefore Test Versions.

Mumble-Server:
The Mumble-Installer includes an option to install the Mumble-Server.

Mac OS X

Mumble:
Download the latest stable version of Mumble from the Official Website.

Alternatively you can download the latest version from the: GitHub releases page.
Note: Releases that include the term "RC" are Release Candidates and therefore Test Versions.

In order to be able to use the Overlay it has to be installed separately.
To install it: launch Mumble, go into Mumble's settings -> 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.

Mumble-Server:
You can download a static version of the Mumble-Server from the Official Website.

Linux

On the most popular Linux distributions, Mumble should be available in the official repositories or third-party repositories.
For Details, take a look at the distribution-sections below.
If no package is available, take a look at the Snap- and Flatpak-packages below (which will run on various distributions) or you can try to compile Mumble, see Section: Building-Mumble.

Debian

To install Mumble from the Debian Repository, run:

apt-get install mumble

For the Mumble-Server, run:

apt-get install mumble-server
Icons oxygen 48x48 actions view-pim-notes.png
Note:
The mumble-server-Package on Debian and Debian-based distributions (i.a. Ubuntu) will start automatically on system-start.

You can disable the autostart with systemd.

You find details in the file "README.Debian".

Ubuntu

The Ubuntu Repositories include a Mumble version from the time when the Ubuntu Version was released, thus it might be outdated.
We also maintain a PPA (stable) with the recent versions of Mumble.
If you want to try the latest development version, you can use the: (dev snapshots)

To add the PPA use:

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
Icons oxygen 48x48 actions view-pim-notes.png
Note:
The mumble-server-Package in Ubuntu will start automatically on system-start.

You can disable the autostart with systemd.

You find details in the file "README.Debian".

RHEL (and its derivatives, such as CentOS)

Please see the Install CentOS5 page for both packaged and manual Mumble Server 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

Install from Fedora Repositories:

To install mumble, run:

 dnf install mumble

For the Mumble-Server, run:

 dnf install murmur

There are additional packages available for the Overlay and Plugins:

  • mumble-overlay
  • mumble-plugins

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 from the Arch Repositories, run:

pacman -S mumble

For the Mumble Server (aka Murmur):

pacman -S murmur

There are also unstable packages available in 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.

Snap Package (for various Distributions)

An Snap Package is available: https://snapcraft.io/mumble

It is maintained by a third-party: the Snapcrafters.

Flatpak Package (for various Distributions)

A Flatpak Package is available: https://www.flathub.org/apps/details/info.mumble.Mumble

Building Mumble

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

BSD

FreeBSD

To install Mumble:

pkg install mumble

To install Murmur:

pkg install murmur

To enable Murmur:

sysrc murmur_enable="YES"

OpenBSD

To install Mumble:

pkg_add mumble

To install the Mumble-Server (Murmur):

pkg_add murmur

To enable Mumble-Server:

rcctl enable murmurd
Icons oxygen 48x48 actions view-pim-notes.png
Note:
The murmur package became available with the release of OpenBSD 6.7 and doesn't exist in OpenBSD 6.6 and previous releases.

Smartphones

Android

Mumla is an unofficial client (by Quite), it's the successor of deprecated Plumble.

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 Mumla on F-Droid and on the Google Playstore.

iPhone

Icons oxygen 48x48 actions view-pim-notes.png
Note:
The iOS client is outdated!

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.