Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/goofball222/murmur
Murmur server (Mumble) Docker container - https://mumble.info
https://github.com/goofball222/murmur
docker-container mumble mumble-server murmur
Last synced: about 1 month ago
JSON representation
Murmur server (Mumble) Docker container - https://mumble.info
- Host: GitHub
- URL: https://github.com/goofball222/murmur
- Owner: goofball222
- License: apache-2.0
- Created: 2018-03-01T05:03:38.000Z (almost 7 years ago)
- Default Branch: main
- Last Pushed: 2022-01-17T20:36:44.000Z (almost 3 years ago)
- Last Synced: 2023-03-01T05:10:40.815Z (almost 2 years ago)
- Topics: docker-container, mumble, mumble-server, murmur
- Language: Shell
- Homepage:
- Size: 35.2 KB
- Stars: 33
- Watchers: 8
- Forks: 15
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: docs/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Murmur Docker Container
[](https://github.com/goofball222/murmur/actions/workflows/build-latest.yml) [](https://hub.docker.com/r/goofball222/murmur/) [](https://hub.docker.com/r/goofball222/murmur/) [](https://microbadger.com/images/goofball222/murmur)
| Docker Tag | Murmur Version | Description | Release Date |
| --- | :---: | --- | :---: |
| [latest](https://github.com/goofball222/murmur/blob/main/stable/Dockerfile) | 1.3.4 | Latest stable release | 2021-02-10 |
| [1.3.4](https://github.com/goofball222/murmur/releases/tag/1.3.4) | 1.3.4 | Static stable release tag/image | 2021-02-10 |
---
* [Recent changes, see: GitHub CHANGELOG.md](https://github.com/goofball222/murmur/blob/main/CHANGELOG.md)
* [Report any bugs, issues or feature requests on GitHub](https://github.com/goofball222/murmur/issues)
---
## Usage
This container exposes four volumes:
* `/opt/murmur/cert` - Murmur SSL certificate files
* `/opt/murmur/config` - Murmur configuration files
* `/opt/murmur/data` - Murmur database and other data files
* `/opt/murmur/log` - Murmur log for troubleshooting
This container exposes two ports:
* `64738/tcp` Murmur server TCP port
* `64738/udp` Murmur server UDP port
---
**The most basic way to run this container:**
```bash
$ docker run --name murmur -d \
-p 64738:64738/udp -p 64738:64738 \
goofball222/murmur
```
---
**Recommended: run via [Docker Compose](https://docs.docker.com/compose/):**
Have the container store the config & logs on a local file-system or in a specific, known data volume (recommended for persistence and
troubleshooting):
```bash
version: '3'
services:
murmur:
image: goofball222/murmur
container_name: murmur
ports:
- 64738:64738
- 64738:64738/udp
volumes:
- /etc/localtime:/etc/localtime:ro
- ./cert:/opt/murmur/cert
- ./config:/opt/murmur/config
- ./data:/opt/murmur/data
- ./log:/opt/murmur/log
environment:
- TZ=UTC
```
[Example `docker-compose.yml` file](https://raw.githubusercontent.com/goofball222/murmur/main/examples/docker-compose.yml)
---
**Environment variables:**
| Variable | Default | Description |
| :--- | :---: | --- |
| `DEBUG` | ***false*** | Set to *true* for extra entrypoint script verbosity for debugging |
| `MURMUR_OPTS` | ***unset*** | Any additional custom run flags for the container murmur.x86 process |
| `MURMUR_SUPW` | ***unset*** | Used to set/change the superuser password on the command line. **NB/IMPORTANT:** By design Murmur will not fully start or accept connections with the -supw command line option set. Start the container once to change the password, then stop the container and remove the variable. |
| `PGID` | ***999*** | Specifies the GID for the container internal murmur group (used for file ownership) |
| `PUID` | ***999*** | Specifies the UID for the container internal murmur user (used for process and file ownership) |
| `RUN_CHOWN` | ***true*** | Set to *false* to disable the container automatic `chown` at startup. Speeds up startup process on overlay2 Docker hosts. **NB/IMPORTANT:** It's critical that you insure directory/data permissions on all mapped volumes are correct before disabling this or murmur will not start. |
---
**SSL custom certificate support ([LetsEncrypt](https://letsencrypt.org/), etc.):**
1. Map the Docker host cert storage location or volume to the `/opt/murmur/cert` volume exposed by the container
2. Must contain a PEM format SSL private key corresponding to the SSL certificate to be installed.
Private key file **MUST** be named `privkey.pem`.
3. Must contain a PEM format SSL certificate file with the full certification chain. LetsEncrypt handles this automatically, other providers may need manual work (https://www.digicert.com/ssl-support/pem-ssl-creation.htm).
Certificate file **MUST** be named `fullchain.pem`.
4. Start the container. sslCert and sslKey paths in murmur.ini are updated automatically during startup if SSL certificate files are detected. Status, errors, etc. can be found in the container log, IE: `docker logs `
If you don't want to use a custom SSL certificate then the `/opt/murmur/cert` volume can be left unmapped. Alternatively if the `privkey.pem` and/or `fullchain.pem` file are not present SSL customization will be skipped.
To revert from a custom cert to a Murmur self-signed certificate: stop the container, rename or remove both privkey.pem and fullchain.pem from `/DATA_VOLUME/murmur/cert`. Then edit the murmur.ini file in `/DATA_VOLUME/murmur/config` and change the lines `sslCert=/opt/murmur/cert/fullchain.pem` to `;sslCert=` & `sslKey=/opt/murmur/cert/privkey.pem` to `;sslKey=`, save the file, and restart the container.
[//]: # (Licensed under the Apache 2.0 license)
[//]: # (Copyright 2018 The Goofball - [email protected])