coop-cloud/mumble
1
0
Fork 0
Code Issues 2 Pull Requests 1 Projects Releases Wiki Activity

additional-config-options #3

Merged
amras merged 7 commits from additional-config-options into main 2026-04-29 08:04:23 +00:00
Conversation 1 Commits 7 Files Changed 5
+137 -4
7 Commits
Author SHA1 Message Date
amras e4eba96d53 [chore] update minor version
continuous-integration/drone/pr Build is failing
Details 
Previous commits introduced new config options:
- passwords
- several misc mumble-server.ini settings

since the new setup requires superuser-pw to be set,
 it is a breaking change compared to 0.1.0
 however, 0.y.z is not considered stable by semver,
 so we're free to increment the minor version.
 2026-04-28 14:01:42 +00:00
amras 11589df06e [fix] backwards compatible env 
As per https://docs.coopcloud.tech/maintainers/upgrade/#backwards-compatible-environment-variable-changes

moved the defaults for the new mumble-server.ini variables
 from .env.sample to the compose file
 2026-04-28 13:36:05 +00:00
amras e8766522d2 [fix] Include default values in .env 
When a MUMBLE_CONFIG var is set, mumble will use it even if it is empty.
This caused problems e.g. when USERNAME="" caused all usernames to be
rejected.

One option to resolve this would be to keep unset-in-config variables
unset in the container. The other option is to supply mumble's default
values to the .env (which also makes the values more explicit).

This commit also removes a few config variables:
SSL would require more work to set up, as the server would need access
to the cert files
REGISTER is skipped for now as it would require an extra secret
LOG_DAYS is skipped because I'm not sure the logs are visible to the
user
 2026-04-27 14:45:29 +00:00
amras a96464676e [doc] update README with new configs 2026-04-27 13:25:34 +00:00
amras e2c946339d Merge branch 'main' into additional-config-options 2026-04-27 13:17:11 +00:00
amras 069298a9f0 [feat] add options from mumble-server.ini 
Most of the options from mumble-server.ini have been added to .env
No documentation for these settings, since they're described elsewhere.

The exceptions which were not included are:
- *ssl* : adding support for custom certs needs more work
- database, *db*, *sqlite* : as above, for databases
- *ice* : unclear how ZeroC Ice works, decided to skip for now
- logfile, pidfile, *log* : would need to expose these files outside the
  container
- port, host, uname : unneccessary in a container
- legacypasswordhash : unsecure, therefore requires custom compose file
- forceExternalAuth : undocumented

Reference:
on environment variables to set config options in the container: https://github.com/mumble-voip/mumble-docker/blob/a0ab293b2a286032b21ec12d84ad24bc10f20dbd/README.md#configuration
list of options: https://github.com/mumble-voip/mumble/blob/v1.6.870/auxiliary_files/mumble-server.ini
 2026-04-23 21:00:47 +00:00
amras a2e9b642bc [feat] server and superuser passwords 
Impl note: server-pw can be ignored for a password-less server,
 e.g. if operator wants to run a publicly registered server:
 https://www.mumble.info/documentation/administration/config-file/#server-registration

Impl note: secret names (-pw rather than -password) are shortened due to R015.
 2026-04-23 21:00:47 +00:00