Mumble Installation Guide

Mumble is a free and open-source Voice Server. Low-latency, high quality voice chat

Voice chat🟡 intermediate10 min⏱️ 15-30 minutes

Mumble is a free and open-source Voice Server. Low-latency, high quality voice chat

1. Prerequisites

  • Hardware Requirements:
  • CPU: 2 cores minimum (4+ cores recommended)
  • RAM: 2GB minimum (4GB+ recommended)
  • Storage: 1GB for installation
  • Network: 64738 ports
  • Operating System:
  • Linux: Any modern distribution (RHEL, Debian, Ubuntu, CentOS, Fedora, Arch, Alpine, openSUSE)
  • macOS: 10.14+ (Mojave or newer)
  • Windows: Windows Server 2016+ or Windows 10
  • FreeBSD: 11.0+
  • Network Requirements:
  • Port 64738 (default mumble port)
  • Dependencies:
  • libqt5core5a, libprotobuf17
  • System Access: root or sudo privileges required
  • 2. Supported Operating Systems

    This guide supports installation on:

  • RHEL 8/9 and derivatives (CentOS Stream, Rocky Linux, AlmaLinux)
  • Debian 11/12
  • Ubuntu 20.04/22.04/24.04 LTS
  • Arch Linux (rolling release)
  • Alpine Linux 3.18+
  • openSUSE Leap 15.5+ / Tumbleweed
  • SUSE Linux Enterprise Server (SLES) 15+
  • macOS 12+ (Monterey and later)
  • FreeBSD 13+
  • Windows 10/11/Server 2019+ (where applicable)
  • 3. Installation

    RHEL/CentOS/Rocky Linux/AlmaLinux

    bash
    # Install EPEL repository if needed
    sudo dnf install -y epel-release
    
    # Install mumble
    sudo dnf install -y mumble libqt5core5a, libprotobuf17
    
    # Enable and start service
    sudo systemctl enable --now mumble-server
    
    # Configure firewall
    sudo firewall-cmd --permanent --add-service=mumble
    sudo firewall-cmd --reload
    
    # Verify installation
    mumble --version || systemctl status mumble-server

    Debian/Ubuntu

    bash
    # Update package index
    sudo apt update
    
    # Install mumble
    sudo apt install -y mumble libqt5core5a, libprotobuf17
    
    # Enable and start service
    sudo systemctl enable --now mumble-server
    
    # Configure firewall
    sudo ufw allow 64738
    
    # Verify installation
    mumble --version || systemctl status mumble-server

    Arch Linux

    bash
    # Install mumble
    sudo pacman -S mumble
    
    # Enable and start service
    sudo systemctl enable --now mumble-server
    
    # Verify installation
    mumble --version || systemctl status mumble-server

    Alpine Linux

    bash
    # Install mumble
    apk add --no-cache mumble
    
    # Enable and start service
    rc-update add mumble-server default
    rc-service mumble-server start
    
    # Verify installation
    mumble --version || rc-service mumble-server status

    openSUSE/SLES

    bash
    # Install mumble
    sudo zypper install -y mumble libqt5core5a, libprotobuf17
    
    # Enable and start service
    sudo systemctl enable --now mumble-server
    
    # Configure firewall
    sudo firewall-cmd --permanent --add-service=mumble
    sudo firewall-cmd --reload
    
    # Verify installation
    mumble --version || systemctl status mumble-server

    macOS

    bash
    # Using Homebrew
    brew install mumble
    
    # Start service
    brew services start mumble
    
    # Verify installation
    mumble --version

    FreeBSD

    bash
    # Using pkg
    pkg install mumble
    
    # Enable in rc.conf
    echo 'mumble-server_enable="YES"' >> /etc/rc.conf
    
    # Start service
    service mumble-server start
    
    # Verify installation
    mumble --version || service mumble-server status

    Windows

    powershell
    # Using Chocolatey
    choco install mumble
    
    # Or using Scoop
    scoop install mumble
    
    # Verify installation
    mumble --version

    Initial Configuration

    Basic Configuration

    bash
    # Create configuration directory if needed
    sudo mkdir -p /etc/mumble-server
    
    # Set up basic configuration
    sudo tee /etc/mumble-server/mumble.conf << 'EOF'
    # Mumble Configuration
    bandwidth=72000
    EOF
    
    # Test configuration
    sudo mumble -t || sudo mumble-server configtest
    
    # Reload service
    sudo systemctl reload mumble-server

    Security Hardening

    bash
    # Set appropriate permissions
    sudo chown -R mumble:mumble /etc/mumble-server
    sudo chmod 750 /etc/mumble-server
    
    # Enable security features
    # See security section for detailed hardening steps

    5. Service Management

    systemd (RHEL, Debian, Ubuntu, Arch, openSUSE)

    bash
    # Enable service
    sudo systemctl enable mumble-server
    
    # Start service
    sudo systemctl start mumble-server
    
    # Stop service
    sudo systemctl stop mumble-server
    
    # Restart service
    sudo systemctl restart mumble-server
    
    # Reload configuration
    sudo systemctl reload mumble-server
    
    # Check status
    sudo systemctl status mumble-server
    
    # View logs
    sudo journalctl -u mumble-server -f

    OpenRC (Alpine Linux)

    bash
    # Enable service
    rc-update add mumble-server default
    
    # Start service
    rc-service mumble-server start
    
    # Stop service
    rc-service mumble-server stop
    
    # Restart service
    rc-service mumble-server restart
    
    # Check status
    rc-service mumble-server status

    rc.d (FreeBSD)

    bash
    # Enable in /etc/rc.conf
    echo 'mumble-server_enable="YES"' >> /etc/rc.conf
    
    # Start service
    service mumble-server start
    
    # Stop service
    service mumble-server stop
    
    # Restart service
    service mumble-server restart
    
    # Check status
    service mumble-server status

    launchd (macOS)

    bash
    # Using Homebrew services
    brew services start mumble
    brew services stop mumble
    brew services restart mumble
    
    # Check status
    brew services list | grep mumble

    Windows Service Manager

    powershell
    # Start service
    net start mumble-server
    
    # Stop service
    net stop mumble-server
    
    # Using PowerShell
    Start-Service mumble-server
    Stop-Service mumble-server
    Restart-Service mumble-server
    
    # Check status
    Get-Service mumble-server

    Advanced Configuration

    Performance Optimization

    bash
    # Configure performance settings
    cat >> /etc/mumble-server/mumble.conf << 'EOF'
    bandwidth=72000
    EOF
    
    # Apply system tuning
    sudo sysctl -w net.core.somaxconn=65535
    sudo sysctl -w net.ipv4.tcp_max_syn_backlog=65535
    
    # Restart service
    sudo systemctl restart mumble-server

    Clustering and High Availability

    bash
    # Configure clustering (if supported)
    # See official documentation for cluster setup
    
    # Basic load balancing setup example
    # Configure multiple instances on different ports

    Reverse Proxy Setup

    nginx Configuration

    nginx
    upstream mumble_backend {
        server 127.0.0.1:64738;
        server 127.0.0.1:{default_port}1 backup;
    }
    
    server {
        listen 80;
        server_name mumble.example.com;
        return 301 https://$server_name$request_uri;
    }
    
    server {
        listen 443 ssl http2;
        server_name mumble.example.com;
    
        ssl_certificate /etc/ssl/certs/mumble.example.com.crt;
        ssl_certificate_key /etc/ssl/private/mumble.example.com.key;
    
        location / {
            proxy_pass http://mumble_backend;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
            
            # WebSocket support (if needed)
            proxy_http_version 1.1;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection "upgrade";
        }
    }

    Apache Configuration

    apache
    <VirtualHost *:80>
        ServerName mumble.example.com
        Redirect permanent / https://mumble.example.com/
    </VirtualHost>
    
    <VirtualHost *:443>
        ServerName mumble.example.com
        
        SSLEngine on
        SSLCertificateFile /etc/ssl/certs/mumble.example.com.crt
        SSLCertificateKeyFile /etc/ssl/private/mumble.example.com.key
        
        ProxyRequests Off
        ProxyPreserveHost On
        
        ProxyPass / http://127.0.0.1:64738/
        ProxyPassReverse / http://127.0.0.1:64738/
        
        # WebSocket support (if needed)
        RewriteEngine on
        RewriteCond %{HTTP:Upgrade} websocket [NC]
        RewriteCond %{HTTP:Connection} upgrade [NC]
        RewriteRule ^/?(.*) "ws://127.0.0.1:64738/$1" [P,L]
    </VirtualHost>

    HAProxy Configuration

    haproxy
    frontend mumble_frontend
        bind *:80
        bind *:443 ssl crt /etc/ssl/certs/mumble.pem
        redirect scheme https if !{ ssl_fc }
        default_backend mumble_backend
    
    backend mumble_backend
        balance roundrobin
        option httpchk GET /health
        server mumble1 127.0.0.1:64738 check
        server mumble2 127.0.0.1:{default_port}1 check backup

    Security Configuration

    Basic Security Setup

    bash
    # Set appropriate permissions
    sudo chown -R mumble:mumble /etc/mumble-server
    sudo chmod 750 /etc/mumble-server
    
    # Configure firewall
    sudo firewall-cmd --permanent --add-service=mumble
    sudo firewall-cmd --reload
    
    # Enable SELinux policies (if applicable)
    sudo setsebool -P httpd_can_network_connect on
    
    # Configure fail2ban
    sudo tee /etc/fail2ban/jail.d/mumble.conf << 'EOF'
    [mumble]
    enabled = true
    port = 64738
    filter = mumble
    logpath = /var/log/mumble-server/*.log
    maxretry = 5
    bantime = 3600
    EOF

    SSL/TLS Configuration

    bash
    # Generate SSL certificates
    sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
        -keyout /etc/ssl/private/mumble.key \
        -out /etc/ssl/certs/mumble.crt
    
    # Configure SSL in mumble
    # See official documentation for SSL configuration

    Database Setup

    PostgreSQL Backend (if applicable)

    bash
    # Create database and user
    sudo -u postgres psql << EOF
    CREATE DATABASE mumble_db;
    CREATE USER mumble_user WITH ENCRYPTED PASSWORD 'secure_password';
    GRANT ALL PRIVILEGES ON DATABASE mumble_db TO mumble_user;
    EOF
    
    # Configure mumble to use PostgreSQL
    # See official documentation for database configuration

    MySQL/MariaDB Backend (if applicable)

    bash
    # Create database and user
    sudo mysql << EOF
    CREATE DATABASE mumble_db;
    CREATE USER 'mumble_user'@'localhost' IDENTIFIED BY 'secure_password';
    GRANT ALL PRIVILEGES ON mumble_db.* TO 'mumble_user'@'localhost';
    FLUSH PRIVILEGES;
    EOF

    Performance Optimization

    System Tuning

    bash
    # Kernel parameters
    sudo tee -a /etc/sysctl.conf << EOF
    net.core.somaxconn = 65535
    net.ipv4.tcp_max_syn_backlog = 65535
    net.ipv4.ip_local_port_range = 1024 65535
    net.core.netdev_max_backlog = 5000
    vm.swappiness = 10
    EOF
    
    sudo sysctl -p
    
    # Mumble specific tuning
    bandwidth=72000

    Resource Limits

    bash
    # Configure system limits
    sudo tee -a /etc/security/limits.conf << EOF
    mumble soft nofile 65535
    mumble hard nofile 65535
    mumble soft nproc 32768
    mumble hard nproc 32768
    EOF

    Monitoring

    Prometheus Integration

    yaml
    # prometheus.yml configuration
    scrape_configs:
      - job_name: 'mumble'
        static_configs:
          - targets: ['localhost:64738']
        metrics_path: '/metrics'

    Health Checks

    bash
    # Basic health check script
    #!/bin/bash
    if systemctl is-active --quiet mumble-server; then
        echo "Mumble is running"
        exit 0
    else
        echo "Mumble is not running"
        exit 1
    fi

    Log Monitoring

    bash
    # Configure log rotation
    sudo tee /etc/logrotate.d/mumble << 'EOF'
    /var/log/mumble-server/*.log {
        daily
        rotate 14
        compress
        delaycompress
        missingok
        notifempty
        create 0640 mumble mumble
        postrotate
            systemctl reload mumble-server > /dev/null 2>&1 || true
        endscript
    }
    EOF

    9. Backup and Restore

    Backup Script

    bash
    #!/bin/bash
    # Mumble backup script
    BACKUP_DIR="/backup/mumble"
    DATE=$(date +%Y%m%d_%H%M%S)
    
    mkdir -p "$BACKUP_DIR"
    
    # Stop service (if required)
    systemctl stop mumble-server
    
    # Backup configuration
    tar -czf "$BACKUP_DIR/mumble-config-$DATE.tar.gz" /etc/mumble-server
    
    # Backup data (adjust paths as needed)
    tar -czf "$BACKUP_DIR/mumble-data-$DATE.tar.gz" /var/lib/mumble
    
    # Start service
    systemctl start mumble-server
    
    # Clean old backups (keep 30 days)
    find "$BACKUP_DIR" -name "*.tar.gz" -mtime +30 -delete
    
    echo "Backup completed: $BACKUP_DIR"

    Restore Procedure

    bash
    # Stop service
    sudo systemctl stop mumble-server
    
    # Restore configuration
    sudo tar -xzf /backup/mumble/mumble-config-*.tar.gz -C /
    
    # Restore data
    sudo tar -xzf /backup/mumble/mumble-data-*.tar.gz -C /
    
    # Set permissions
    sudo chown -R mumble:mumble /etc/mumble-server
    sudo chown -R mumble:mumble /var/lib/mumble
    
    # Start service
    sudo systemctl start mumble-server

    6. Troubleshooting

    Common Issues

    1. Service won't start:

    bash
    # Check logs
    sudo journalctl -u mumble-server -n 100
    sudo tail -f /var/log/mumble-server/*.log
    
    # Check configuration
    sudo mumble -t || sudo mumble-server configtest
    
    # Check permissions
    ls -la /etc/mumble-server
    ls -la /var/lib/mumble

    2. Connection refused:

    bash
    # Check if service is listening
    sudo ss -tlnp | grep 64738
    sudo netstat -tlnp | grep 64738
    
    # Check firewall
    sudo firewall-cmd --list-all
    sudo iptables -L -n
    
    # Test connection
    telnet localhost 64738
    nc -zv localhost 64738

    3. Performance issues:

    bash
    # Check resource usage
    top -p $(pgrep murmurd)
    htop -p $(pgrep murmurd)
    
    # Check connections
    ss -ant | grep :64738 | wc -l
    
    # Monitor I/O
    iotop -p $(pgrep murmurd)

    Debug Mode

    bash
    # Run in debug mode
    sudo mumble -d
    # or
    sudo mumble-server debug
    
    # Increase log verbosity
    # Edit configuration to enable debug logging

    Integration Examples

    Docker Compose

    yaml
    version: '3.8'
    services:
      mumble:
        image: mumble:latest
        container_name: mumble
        ports:
          - "64738:64738"
        volumes:
          - ./config:/etc/mumble-server
          - ./data:/var/lib/mumble
        environment:
          - mumble_CONFIG=/etc/mumble-server/mumble.conf
        restart: unless-stopped
        networks:
          - mumble_net
    
    networks:
      mumble_net:
        driver: bridge

    Kubernetes Deployment

    yaml
    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: mumble
    spec:
      replicas: 3
      selector:
        matchLabels:
          app: mumble
      template:
        metadata:
          labels:
            app: mumble
        spec:
          containers:
          - name: mumble
            image: mumble:latest
            ports:
            - containerPort: 64738
            volumeMounts:
            - name: config
              mountPath: /etc/mumble-server
          volumes:
          - name: config
            configMap:
              name: mumble-config
    ---
    apiVersion: v1
    kind: Service
    metadata:
      name: mumble
    spec:
      selector:
        app: mumble
      ports:
      - port: 64738
        targetPort: 64738
      type: LoadBalancer

    Ansible Playbook

    yaml
    ---
    - name: Install and configure Mumble
      hosts: all
      become: yes
      tasks:
        - name: Install mumble
          package:
            name: mumble
            state: present
        
        - name: Configure mumble
          template:
            src: mumble.conf.j2
            dest: /etc/mumble-server/mumble.conf
            owner: mumble
            group: mumble
            mode: '0640'
          notify: restart mumble
        
        - name: Start and enable mumble
          systemd:
            name: mumble-server
            state: started
            enabled: yes
      
      handlers:
        - name: restart mumble
          systemd:
            name: mumble-server
            state: restarted

    Maintenance

    Update Procedures

    bash
    # RHEL/CentOS/Rocky/AlmaLinux
    sudo dnf update mumble
    
    # Debian/Ubuntu
    sudo apt update && sudo apt upgrade mumble
    
    # Arch Linux
    sudo pacman -Syu mumble
    
    # Alpine Linux
    apk update && apk upgrade mumble
    
    # openSUSE
    sudo zypper update mumble
    
    # FreeBSD
    pkg update && pkg upgrade mumble
    
    # Always backup before updates
    tar -czf /backup/mumble-pre-update-$(date +%Y%m%d).tar.gz /etc/mumble-server
    
    # Restart after updates
    sudo systemctl restart mumble-server

    Regular Maintenance Tasks

    bash
    # Clean logs
    find /var/log/mumble-server -name "*.log" -mtime +30 -delete
    
    # Verify integrity
    sudo mumble --verify || sudo mumble-server check
    
    # Update databases (if applicable)
    sudo mumble-update-db
    
    # Optimize performance
    sudo mumble-optimize
    
    # Check for security updates
    sudo mumble --security-check

    Additional Resources

  • Official Documentation: https://docs.mumble.org/
  • GitHub Repository: https://github.com/mumble/mumble
  • Community Forum: https://forum.mumble.org/
  • Wiki: https://wiki.mumble.org/
  • Comparison vs TeamSpeak, Discord, Ventrilo, Element: https://docs.mumble.org/comparison
  • ---

    Note: This guide is part of the HowToMgr collection. Always refer to official documentation for the most up-to-date information.