Difference between revisions of "Installing Mumble"

From Mumble Wiki
Jump to: navigation, search
(Linux)
m (Added a reference to making Mumble use CA's certificate.)
(25 intermediate revisions by 17 users not shown)
Line 1: Line 1:
=Introduction=
 
 
 
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 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.
  
Line 9: Line 7:
 
==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. The installer includes both the client and the 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).
  
(for Win2000 see [[Tips_Tricks]])
+
For Win2000 see [[Tips_Tricks#Installation_of_the_Mumble_client_on_Windows_2000|Tips Tricks]]
  
 
==Mac OS X==
 
==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].  
+
'''Precompiled Mac OS X universal binaries''' are available from the [https://github.com/mumble-voip/mumble/releases 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 [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'''.
  
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'''.
+
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==
 
==Linux==
  
For most Linux distributions, the client package name is ''mumble'' and the server package name is ''mumble-server'' or ''murmur''. For many Debian-based distributions, there is ''mumble-server-web'', which is a turnkey installation of ICE for Murmur.
+
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.
+
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.
  
 
==== Debian ====
 
==== Debian ====
 +
{{Warning
 +
|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.
 +
}}
 +
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).
  
'''Note that for 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.'''
+
'''Mumble'''
 
 
Debian unstable has the latest release at all times in it's repository, and snapshots in experimental. Backports to current stable are done as soon as the package reaches testing (usually a week after release).
 
 
 
 
  apt-get install mumble
 
  apt-get install mumble
or
+
'''Murmur'''
 
  apt-get install mumble-server
 
  apt-get install mumble-server
 
  dpkg-reconfigure mumble-server
 
  dpkg-reconfigure mumble-server
Line 40: Line 41:
 
Ubuntu carries whatever Mumble version was current at the time of the release in the universe repository. We also maintain a PPA that has the latest version for recent Ubuntu versions
 
Ubuntu carries whatever Mumble version was current at the time of the release in the universe repository. We also maintain a PPA that has the latest version for recent Ubuntu versions
  
  sudo add-apt-repository ppa:slicer
+
  sudo add-apt-repository ppa:mumble/release
 
  sudo apt-get update
 
  sudo apt-get update
 +
 +
To install the client you can use:
  
 
  sudo apt-get install mumble
 
  sudo apt-get install mumble
or
+
 
 +
to install and configure the server use:
 +
 
 
  sudo apt-get install mumble-server
 
  sudo apt-get install mumble-server
 
  sudo dpkg-reconfigure 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 <tt>mumble-*</tt>, such as <tt>mumble-overlay</tt> and <tt>mumble-server-web</tt>. 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 ===
 
=== SUSE ===
  
Uptodate packages can be found in the [http://download.opensuse.org/repositories/home:/lnussel:/mumble:/unstable/ Build Service].
+
Mumble packages are available from [http://software.opensuse.org/package/mumble software.opensuse.org].
 +
 
 +
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
 +
 
 +
 
 +
''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.''
 +
 
 +
Some packages can also be found in the [http://download.opensuse.org/repositories/home:/lnussel:/mumble:/unstable/ Build Service].
  
 
=== Arch Linux ===
 
=== Arch Linux ===
Line 59: Line 102:
 
  pacman -S murmur
 
  pacman -S murmur
  
There are also unstable packages in AUR:
+
There are also unstable packages on the AUR:
* Mumble Unstable (updated directly from Git): http://aur.archlinux.org/packages.php?ID=26865
+
* Mumble Unstable (updated directly from Git): https://aur.archlinux.org/packages/mumble-git/
* Murmur Unstable (updated directly from Git): http://aur.archlinux.org/packages.php?ID=32900
+
* Murmur Unstable (updated directly from Git): https://aur.archlinux.org/packages/murmur-git/
* Murmur ICE (with ICE support): http://aur.archlinux.org/packages.php?ID=19980
+
* Murmur ICE (with ICE support): https://aur.archlinux.org/packages/murmur-ice/
* umurmur (minimalistic murmur): http://aur.archlinux.org/packages.php?ID=38982
+
 
 +
=== 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 ===
 
=== Others ===
  
If all of the above options fail to work, you can always try [[BuildingLinux|compiling Mumble from source]].
+
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".
  
 
== Smartphones ==
 
== Smartphones ==
Line 73: Line 123:
  
 
=== Android ===
 
=== Android ===
One of our core developers is currently working on reimplementing a Mumble client for the Android OS. You can follow the efforts in the [http://github.com/pcgod/mumble-android Mumble Android Git repository]. Binary version for testing are also available [http://github.com/pcgod/mumble-android/downloads there].
+
Plumble is an unofficial client made by Morlunk.
 +
 
 +
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 [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].
  
 
=== iPhone ===
 
=== iPhone ===
There is currently an iPhone version of Mumble in the works; you can find more information about it from the [http://mumble.git.sourceforge.net/git/gitweb.cgi?p=mumble/mumble-iphoneos;a=summary iPhone Git repository]. Any help with the project is always appreciated.
+
The Mumble iOS client is available [https://itunes.apple.com/us/app/mumble/id443472808?mt=8 on the App Store].
 +
 
 +
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.
  
 
=== Maemo (Nokia) ===
 
=== 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.
 
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.
  
{{Docs en}}
+
[[Category:Documentation English]]

Revision as of 15:19, 11 March 2017

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