User Roles Reference

mailserver-admin defines three roles with different permissions.

Admin

  • Manage all domains, users, aliases, and DKIM
  • Full access to all features

Domain Admin

  • Manage users, aliases, and fetchmail within their assigned domain only
  • Can read users with the admin flag in their own domain, but cannot change or delete them, including resetting their password or disabling them. Only admins can change or delete an admin.
  • Cannot add, edit, or delete domains
  • Cannot manage DKIM

User

  • Log in to the application
  • Manage own fetchmail accounts
  • Change own password (subject to password policy)
  • Cannot manage users, aliases, or domains
  • No access to DKIM or domain configuration

Mailboxes

Through the MCP server, every role reaches only its own mailbox. Admin and Domain Admin grant no access to other people's mail.

MCP server and API tokens

A call to the MCP server succeeds only if the API token carries the required scope and the owner's current role allows the action on that object. A token never exceeds the role of its owner.

Tool group Admin Domain Admin User
Domains: list, create, delete all no no
Users: list, get, create, update, delete all own domain no
Aliases: list, get, create, update, delete all own domain no
Fetchmail: list, get, create, update, delete all own domain own accounts
DKIM: status, enable, disable, recreate key all no no
DNS validation all domains own domain no
Mail: read, send own mailbox own mailbox own mailbox

The same rules as in the web interface apply: only admins can set admin, choose a domain, or change or delete a user with the admin flag, users cannot change their own role or enabled state or delete themselves, and only empty domains can be deleted. Mail tools refuse disabled users, and the read tools also refuse send-only users.

API tokens Admin Domain Admin User
Create for oneself yes yes yes
See and revoke own yes yes yes
See and revoke other all own domain no