Difference between revisions of "Installing Mumble"

From Mumble Wiki
Jump to: navigation, search
m (Linux)
m (Added a reference to making Mumble use CA's certificate.)
(54 intermediate revisions by 21 users not shown)
Line 1: Line 1:
'''Please edit this page if you find a feature or step you think should be included; it's a wiki for a reason! Note you must register and wait about 3 days in order to be able to edit.'''
+
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.
  
=Getting and Installing Mumble=
+
__TOC__
  
This page shows you directions on how to install Mumble (client) as well as Murmur (server).
+
=Getting and Installing Mumble and Murmur=
  
 
==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#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 ''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.
  
However, for Debian distributions, the server package name is ''mumble-server''.
+
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.
  
On the popular Linux distributions, both Mumble and Murmur should be available in either third party repositories, or the official repository. See the distribution sections below.
+
==== 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).
  
'''If''' you do not find an appropriate Murmur (server) package for your distribution, the [http://mumble.info/snapshot/ static build] will usually work. Static builds start with "murmur-static_x86."
+
'''Mumble'''
 +
apt-get install mumble
 +
'''Murmur'''
 +
apt-get install mumble-server
 +
dpkg-reconfigure mumble-server
  
'''If''' you do not find an appropriate Mumble package for your distribution, there are now experimental static Mumble builds available from [http://www.0xy.org/mumble/ here] (64 and 32 bit compatible). '''Do NOT use these unless you are sure that the Mumble is not available in your own package manager or third-party repositories -- use these builds at your own risk; they have not been thoroughly tested yet.'''
+
==== Ubuntu ====
  
If all of the above options fail to work, you can always try [[BuildingLinux|compiling Mumble/Murmur from source]].
+
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
  
Note that on Debian-based systems, you can use the package
+
  sudo add-apt-repository ppa:mumble/release
  mumble-server-web
+
sudo apt-get update
for a turn-key, ready to go ICE installation (it also includes some scripts by default). Simply install it after you have installed mumble-server.
 
  
==== Debian ====
+
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?).
  
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).
+
For CentOS 6 see the [[Install CentOS6]] page.
  
To configure the server, just 'dpkg -reconfigure mumble-server'.
+
For CentOS 7 see the [[Install CentOS7]] page.
  
==== Ubuntu ====
+
=== Fedora ===
  
'''Note that you should use the PulseAudio sound system for Mumble if you are running Ubuntu.'''
+
Fedora 13-21, use yum:
 +
  yum install mumble
  
Ubuntu carries whatever Mumble version was current at the time of the release in the universe repository. '''Backports of current releases can be found [https://launchpad.net/~slicer/+archive/ppa in the PPA].''' If you do not have the current version of Mumble available in your repositories, [https://launchpad.net/~slicer/+archive/ppa add the PPA].
+
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.
  
If you are going to use the PPA, click the above link, select "Technical Details" and copy the two repositories to ''/etc/apt/sources.list'', then add the signing key. Note that you must have the Universe repository enabled so that Mumble can install the needed dependencies.
+
Fedora 22+, use dnf:
 +
  dnf install mumble
  
Configure the server using 'sudo dpkg-reconfigure mumble-server'.
+
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 ===
 +
To install Mumble, use pacman:
 +
pacman -S mumble
 +
 +
For the Mumble Server Murmur:
 +
pacman -S murmur
 +
 +
There are also unstable packages  on the AUR:
 +
* Mumble Unstable (updated directly from Git): https://aur.archlinux.org/packages/mumble-git/
 +
* 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/
 +
 +
=== 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 [[BuildingLinux|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.
  
There are two Mumble packages in AUR:
+
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.
* Stable release: http://aur.archlinux.org/packages.php?ID=10221
 
* Unstable (updated directly from Git): http://aur.archlinux.org/packages.php?ID=26865
 
  
Murmur (the server) can also be found here: http://aur.archlinux.org/packages.php?ID=19928
+
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].
  
=Using Mumble=
+
=== iPhone ===
 +
The Mumble iOS client is available [https://itunes.apple.com/us/app/mumble/id443472808?mt=8 on the App Store].
  
Client: [[Mumbleguide|Mumbleguide]]
+
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.
  
Server: [[Murmurguide|Murmurguide]]
+
=== 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 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.