mumble-server(1)

πŸ’– mumble-server(1) β€” the manual, but make it cute πŸ’–

General Commands Manual Β· ok bestie, sit down, we're learning the VoIP server πŸ’…


✨ NAME ✨

mumble-server β€” it's a VoIP server. That's the whole vibe. Voice over IP, server edition. πŸŽ€


🌸 SYNOPSIS 🌸

mumble-server [-ini inifile] [-fg] [-v]
mumble-server -supw password [serverid]
mumble-server -readsupw [serverid]
mumble-server -disablesu [serverid]
mumble-server -limits
mumble-server -wipessl
mumble-server -wipelogs
mumble-server -loggroups
mumble-server -logacls
mumble-server -license
mumble-server -authors
mumble-server -third-party-licenses
mumble-server -version|--version
mumble-server -h|-help|--help

Like… pick a lane, bestie. Run it plain, or run it with one of the special little modes. No mixing and matching, mwah. πŸ’–


πŸ¦‹ DESCRIPTION πŸ¦‹

So mumble-server is the server component of Mumble β€” and Mumble is a low-latency, high-quality VoIP application. Low latency = the group call doesn't sound like you're talking through a soup can. High quality = it sounds iconic. This is the thing that makes all of that happen. πŸ‘‘


πŸ’… OPTIONS πŸ’…

Ok so here's the menu, bestie. Every single one, no skips. πŸ“

  • -h, -help, --help β€” shows you a lil summary of the options. Like a table of contents but for flags. ✨
  • -ini inifile β€” tells it which ini file to use. If you don't pass this, mumble-server goes hunting for a murmur.ini file, and if it can't find one it just falls back to the builtin defaults. So it's never not gonna run, it's just gonna run with the default fit on. πŸŽ€
  • -fg β€” run in the foreground. As in: do not fork. It stays right there with you, holding your hand. 🫢
  • -v β€” verbose mode. Slightly more stuff gets logged. Slightly. It's giving "tell me more but not too much". πŸ’¬
  • -supw password [serverid] β€” this one sets the SuperUser password for a server. And listen, SuperUser is a special account β€” basically root-coded β€” and it bypasses ALL access controls. Periodt. You can run this command while the server is running, no shutdown required. Optionally takes a serverid representing the virtual server to set the password for. πŸ”‘
  • -readsupw [serverid] β€” reads the SuperUser password from stdin. Optionally takes a serverid representing the virtual server to set the password for. 🧚
  • -disablesu [serverid] β€” disables the SuperUser account. Optionally takes a serverid representing the virtual server to disable the SuperUser account on.

Heads up though: disabling the SuperUser account makes it impossible to log in as SuperUser until a new password is set. So like… don't lose the keys to the castle and then also lock the castle. You can set a new SuperUser password with the -supw parameter. 🚨

  • -limits β€” tests and shows how many file descriptors and threads can be created. The whole point of this one is to test how many clients the server can handle. And then? The server exits after this test. It's a vibe check for your hardware, and then it leaves. πŸ’€
  • -wipessl β€” removes SSL certificates from the database. Wipe. Gone. 🧽
  • -wipelogs β€” removes all log entries from the database. All of them. The whole diary. πŸ““
  • -loggroups β€” turns on logging for group changes for all servers. πŸ‘€
  • -logacls β€” turns on logging for ACL changes for all servers. πŸ”
  • -license β€” shows mumble-server's license. Read it, bestie, it's important. πŸ“œ
  • -authors β€” shows mumble-server's authors. Shoutout time. 🫑
  • -third-party-licenses β€” shows licenses for third-party software used by mumble-server. Because credit where credit is due, always. πŸ’–
  • -version, --version β€” shows version information. πŸ”’

🌈 SIGNALS 🌈

Signals, aka the way you whisper to a running server. πŸ•ŠοΈ

  • SIGHUP β€” performs a log rotation. This makes mumble-server re-open its log file. Fresh log, who dis. πŸ”„
  • SIGUSR1 β€” gracefully reloads the TLS settings specified in murmur.ini without interrupting service. No downtime, no drama, no dropped calls. ✨

When this signal comes through, the server applies the new TLS settings β€” that's the certificate, the private key, and the Diffie-Hellman parameters β€” to all virtual servers that use the TLS settings from murmur.ini.

Important caveat, bestie: virtual servers that have overridden the settings from murmur.ini will not be affected by this signal. Those servers can be updated using the updateCertificate RPC call instead. So don't be shocked when the overriders don't budge β€” they were never gonna listen to SIGUSR1 in the first place. πŸ™ˆ

πŸ‘‘ SEE ALSO πŸ‘‘

Go read those too, iykyk. πŸ¦‹


πŸ’œ AUTHORS πŸ’œ

mumble and mumble-server were written by The Mumble Developers. Absolute icons, no cap. 🫢


and that's the whole page, bestie!! πŸ’– This was the mumble-server(1) manual from 2016 May 9, and yes, that date is giving vintage but the info still slaps. mwah, go run your server, you're doing amazing. πŸ’…βœ¨

πŸ“¦ where this page comes from