Skip to content

Server Administration

Tobias Vorwachs edited this page Nov 12, 2026 · 1 revision

Server administration

Epic 4 gives Mumcord the tools to run a Mumble server from the client: channels, permissions and groups, bans, registered users and admin chat commands. It was delivered step by step: kick and ban with the ban list in 0.7.0, moving people, moderation, channel management and channel permissions in 0.7.2, and registered users, admin chat commands, a clearer Permissions tab and drag and drop of channels in 0.8.0.

Everything works with unmodified, standard Mumble servers. Nothing is installed or changed on the server.

Only what you may do

Mumcord asks the server which rights you have and shows only the actions you may use. An action you have no right for is hidden, not greyed out. Without any admin right you see no Admin sub-menu, no admin commands and no Server administration window. Rights are per server: on each connected server you have your own, and no action spans several servers. When an admin changes your rights while you are connected, they take effect without reconnecting.

When the server refuses something, Mumcord says what and where in plain words, for example "You may not move people in Raid.", unless the dialog that asked shows it already.

The Admin menu

The person menu, the channel menu and the server menu (the three dots on the server) each have an Admin ▸ sub-menu. Red actions come last, behind a divider. Use the arrow keys to open and close a sub-menu (→ opens, ← or Escape goes back).

  • Person menu: Move to my channel, Move to, Server mute, Server deafen (mutes too), Un-suppress, Priority speaker (a star appears next to the name), Register on server (for guests), Reset comment and Reset avatar (only when the person has one), Kick and Ban.
  • Channel menu: Create sub-channel, Create temporary channel, Edit channel, Permissions, Link with my channel, Unlink all, Move everyone to, Delete channel.
  • Server menu: Ban list and Registered users, each only with its right.

Server mute, server deafen, priority speaker and un-suppress act at once and show a tick while on. Reset comment, reset avatar, kick, ban, delete and the other actions that cannot be undone ask first. A confirmation names what is affected and has buttons named after the action, never "OK".

Kick and ban

Kick opens a dialog with an optional reason that is shown to the person; they can reconnect right away. The ban dialog asks for the reason, the length (1 hour, 1 day, 7 days, 30 days, permanent or a custom date), what to ban (the certificate and the IP address with its mask) and whether to remove the person from the server now. A server that will not show its ban list only allows its own default ban length, and the dialog says so.

The Ban list shows the server's bans with name, certificate fingerprint, IP address or range, reason, since and end. You can search, filter by All, Active or Expired, and sort by column. Edit an entry in place (reason and end), unban it, or add a ban for someone who is not online. Changes are collected and saved together after Mumcord reads the server's list again, so a change someone else made meanwhile is not lost. Fingerprints are shortened and addresses masked by default, and nothing of the list is written to disk.

Moving people

  • Move to my channel and Move to (with a filterable channel picker that shows each channel's user limit) move one person. Move everyone to moves a whole channel at once without taking you along, and asks first ("Move 3 people from Raid to Lobby?").
  • Ctrl-click (Cmd-click on macOS) or Ctrl+Space picks several people in the channel tree, and Shift-click or Shift+Space picks a range. One drag then moves them all, and the person menu's Move to carries the picked people.
  • After moving a group, Mumcord says how many arrived ("Moved 28 of 30 people to Raid. The rest were refused.") instead of showing one notice per person.

Drag and drop of channels

Since 0.8.0 you can drag channels in the channel tree:

  • Drop a channel onto another channel to move it there with all its sub-channels and the people in them.
  • Drop it between two channels to change the order.
  • A new parent asks first, naming what moves along and the path before and after. A new spot among the same siblings needs no question.
  • A channel cannot go into itself or its own sub-channels, the root channel stays put, and only channels you may edit can be dragged.
  • When the server refuses, a notice says why and the tree stays as it was.

The Edit dialog (parent and position) remains the keyboard way.

Channel management

The channel menu's Admin ▸ creates a sub-channel or a temporary channel, edits a channel (name, description, parent, position, user limit) and its links, links it with your channel, unlinks all, and deletes it. Delete asks first and names the sub-channels and people affected. With a channel selected, F2 edits it and Delete deletes it.

  • The description has simple formatting and is saved in the form other Mumble clients show.
  • The Password tab sets or clears the password for joining a channel, written the same way as the official Mumble client. Channels with more complex access rules point you to Permissions instead.
  • Changing the parent asks first.

Permissions and groups

The channel window's Permissions tab shows who can do what in the channel and lets you edit its rules and groups. It has three views, and the tab shows which one is open, with the number of rules and groups:

  • Who can do what: a grid with a row per group or person and a cell per permission: ✓ allowed, ✗ denied, ? depends. Click a cell for a Why? panel that names the deciding rule and the group that made the person match. "Check a person" adds someone's row; the small × in the field ends the check (it also ends when that person disconnects). Mumcord works the answer out from the rules it reads; the server has the final say.
  • Rules: the channel's own rules, which you can edit, below the inherited ones.
  • Groups: starts with a prominent New group button and lists a group's members with their picture, how they got in, and one-click remove or restore. A line sums up the group, and long member lists can be filtered. What a group may do opens in its own dialog, See what … can do in ….

Refresh (a small button at the side) reads the rules again. Mumcord protects you from mistakes:

  • It warns before a change would lock you out of rights you hold now.
  • It asks before changing the rules of the root channel, which affect the whole server.
  • It never overwrites a change someone else made meanwhile: it asks whether to reload or save yours anyway.

Registered users

With the server's Register right, the server menu has Registered users, which opens a tab next to Bans in Server administration. It lists every account the server knows, with the account id, the last seen and the last channel. You can search, filter by Online or Inactive 90+ days, rename, unregister, and register someone who is connected right now. Groups that name an account are shown, and one save writes all your changes, with a clear note when the server did not take one. Without the right, the menu item and the tab are not shown.

Server info and the server notice

The server info panel has an Admin section for people with an admin right. It shows your rights here, the server's limits and the welcome text (read-only: it can only be changed in the server's settings file, not from any client). The server notice is the root channel's description. Where you may edit it, Edit opens the rich text editor, and a link opens the ban list and registered users.

Admin commands in the chat box

Type / to list the admin commands this server allows you. They appear above the plugin commands and are marked Built-in. While you type, Mumcord completes the names of the people you may act on and the channels you may move people to. A command you may not use behaves like one that does not exist.

Command What it does
/kick <name> [reason] Opens the kick dialog with the name and reason filled in
/ban <name> [duration] [reason] Opens the ban dialog filled in; the duration is like 1h, 7d or perm
/mute <name>, /unmute <name> Server mute on or off
/deaf <name>, /undeaf <name> Server deafen on or off
/priority <name> Switches priority speaker
/register <name> Registers a guest who is online
/move <name> <channel> Moves one person
/moveall <channel> Moves everyone in your current channel; asks first
/unban <name or IP> Finds the ban and asks before removing it

Kick, ban, unban and move-everyone confirm first. A name typed only in part opens a picker instead of acting right away, and /mute Bob Smith acts on the person with exactly that name. Every command ends with a short result line that only you see in that chat. The command text is never sent, so other clients see only the usual server result. Commands only act on the server whose chat you typed them in.

Privacy

Rights, rules, groups, the ban list and the registered users are kept in memory only while a window is open and are not written to disk. Logs contain only the kind of action and its result, never names, addresses, fingerprints, reasons or channel names. Everything the server sends (names, reasons, descriptions) is sanitized before it is shown.

See also Features, Roadmap and Hotkeys and whisper.

Clone this wiki locally