Administrating Your Server

Initial Setup

When your server is first set up, you will want to set up channels and permissions. This guide will walk you through getting that all set up.

Initial Account Setup

The first step is to log in to your new server as yourself. Once you're logged in, you'll want to right-click on your username, and click Register. This will register your normal account on your server, so that you can grant administrative permissions to it.

/images/help_images/register.png

Once you are registered, disconnect from the server, and then reconnect as the special SuperUser user. This user cannot hear or talk to other users, but has full permissions on the server. If you don't remember your SuperUser password, you can change it by clicking on the Superuser Password tab in your server's details page.

Granting Permissions

Next, we're going to add your new account to the admin group. This will grant you full administrative permissions on the server.

Once you are logged in as SuperUser, right-click on the very top channel of your server, and select Edit. In the dialog that pops up, select the Groups tab. You will then select the dropdown under Groups, and select admin.

/images/help_images/edit_acl.png

Next, in the text entry field under Members, enter the username that you registered on the server in the previous step, and then click Add. Your username should show up in the Members list in a normal font. If it shows up in an italic font then you are trying to add a user to the group that is not registered on the server. If you have problems with it, make sure you have registered your account.

/images/help_images/edit_groups.png

Permissions Setup

You can disconnect as SuperUser now, and reconnect as your normal account. You will have full editing permissions on your new server.

You can begin adding channels now, if you'd like. Right-click on a channel to add a sub-channel, and select Add. Once you've added a few channels, you can start adding specific permissions on those channels and/or their sub-channels.

To change a channel or channel tree's permissions, right-click on the channel and select Edit. This time, we're going to the Groups tab.

Here, you can set up permissions for individual users or groups of users for the channel or channel tree. It's a bit confusing at first, but stick with it - it'll make sense.

For example, let's set permissions on a channel so that only registered users can enter it.

  1. Click Add
  2. For Group select all
  3. Check the Deny column next to Enter. This will prevent all users from entering the channel.
  4. Click Add
  5. For Group, select auth
  6. Check the Allow column next to Enter. This will allow authenticated users to enter the channel.

Congratulations! You've set up your first restricted channel. As you might be able to tell from the options available, you can do a lot of stuff with the user permissions available.

ACL recipes

Here are a few more common ACL recipes for you.

Force people to enter a channel before they can talk.

This one is easy. We're going to just mute the root channel, but none of its sub channels.

  1. Right-click the channel root server, and select Edit.
  2. Click Add, go to the ACL tab, and under Group, select all.
  3. Uncheck Applies to sub-channels. This will make permissions for this entry only apply to this server.
  4. Check Deny next to Speak

Now, users will be automatically muted while they're in the root channel, and can gain speaking permissions by moving to a sub-channel. You can use this same technique to create a muted AFK channel.

There are more recipes and explanation on the Mumble wiki.

Create a channel to hold temporary channels

Temporary channels are a feature that allow you to let others create channels without risking the chance for your server to be spammed up.

  1. Right-click the channel root server, and select Edit.
  2. Select an all entry, or add one.
  3. Check Deny under Make Temporary
  4. Add a channel called Groups (or whatever you would like)
  5. Right-click the Groups channel and select Edit.
  6. Add an entry for auth and check Allow under Make Temporary

This will let authenticated users create any temporary channel they want under the Groups channel.

Groups

Mumble comes with several pre-defined groups.

  • all - All users. Rules set up for the all group will affect all users.
  • auth - Authenticated (registered) users.
  • in - Applies to users who are in this channel, or its sub-channels. This is primarily useful when dealing with linked channels.
  • out - Applies to users who are not in this channel, or its sub-channels. This is primarily useful when dealing with linked channels.
  • sub - @sub is a special group for advanced management. Read about it on the Mumble wiki.

Additionally, you can prefix a group with certain special characters to modify what the group means.

  • Prefix a group with ! to invert the rule (so !auth would match all users that are not authenticated - e.g. anonymous users).
  • Prefix a group with ~ to make the rule apply in the context of the channel that you define the ACL rules in. This is useful for when you have rules that are inherited by sub-channels.

Custom Groups

You can put people into custom groups, as well. For example, if your guild wants to have officers have access to a officers-only channel, you can add them to a custom group. Go to Groups, and type in officers into the group box, and click Add.

Then, under Members, just enter the name of the people that you want to add to the officers group.

You can now add special permissions for the officers group in the ACL tab.

Managing Users

Kicks and Bans

You can kick or ban users by right-clicking a user and selecting Kick or Ban as appropriate. Bans can be set to expire at a set time.

If you need to unban a user, you can go to Server -> Bans, and select the ban you want to modify.

Users Losing Access

If a user who registered with a certificate is being asked for a password when connecting to the server, read restoring lost user access.