Skip to content

Repository files navigation

Mumble Server Auto-Installer

An automated bash script that installs Docker and deploys a Mumble voice server using Docker Compose.

Features

  • Automatic Docker Installation: Uses the official Docker installer from get.docker.com
  • Interactive Configuration: Prompts for all Mumble server settings
  • Firewall Configuration: Automatically configures UFW for SSH and Mumble ports
  • Service Management: Deploys and verifies the Mumble service
  • Backup & Recovery: Creates backups and restores on errors

Usage

  1. Clone or download this repository
  2. Make sure docker-compose.yml is in the same directory
  3. Run the installer:
./install_mumble.sh

Configuration Options

The installer will prompt you for:

  • Server Name (required) - The display name for your Mumble server
  • Welcome Message - HTML-formatted welcome message
  • SuperUser Password - Auto-generated by Mumble server
  • Server Password - Optional password for all users
  • Register Hostname - Public hostname for server registration
  • Register Name - Public name for server listing
  • Register Password - Password for server registration
  • Register URL - Server website URL
  • Port - Mumble server port (default: 64738)
  • Timezone - Server timezone (default: UTC)

Requirements

  • Ubuntu/Debian-based Linux system
  • Sudo privileges
  • Internet connection
  • Existing docker-compose.yml file

Security Features

  • Validates user inputs
  • Secure password entry with confirmation
  • Creates backups of configuration files
  • Configures firewall automatically
  • Adds user to docker group safely

Post-Installation

After installation, you'll receive:

  • Connection information (IP address and port)
  • Auto-generated SuperUser password
  • Useful management commands
  • Firewall status

Management Commands

# View logs
docker compose logs -f

# Stop server
docker compose down

# Start server
docker compose up -d

# Restart server
docker compose restart

Troubleshooting

If you encounter issues:

  1. Check the installer logs for error messages
  2. Verify Docker is running: docker --version
  3. Check container status: docker ps
  4. Review firewall rules: sudo ufw status
  5. Find SuperUser password: docker logs mumble-server | grep 'SuperUser password'

The script automatically creates a backup of your original docker-compose.yml as docker-compose.yml.backup.

About

easy installer script for mumble server targeting Ubuntu and Debian systems

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages