Settings & Administration
Configure server settings, manage admin accounts, activate your license, and set up AI features.
The Settings page is your central hub for server configuration, account management, licensing, and AI features. It has seven tabs -- this page covers the General, Accounts, AI, and License tabs. The other tabs are documented separately:
- Integrations -- see SMTP Relay
- Security -- see IP Access Restrictions
- About -- see Software Updates
General
The General tab configures core server settings.
| Field | Editable | Description |
|---|---|---|
| Hostname | Yes | The fully qualified domain name of your mail server (e.g., mail.example.com) |
| Admin Email | No | Derived from server configuration. Change via Postfix config on the server. |
| Timezone | No | Derived from the server's system timezone. Change via timedatectl on the server. |
| Max Message Size (MB) | Yes | Maximum size for incoming and outgoing emails (1--100 MB) |
| SMTP Banner | Yes | The greeting banner shown to connecting SMTP clients |
Click Save Changes after modifying any editable field.
Accounts
The Accounts tab manages who can log into the dashboard and what they can do.
Creating an account
- Click Add Account
- Enter a username (3--50 characters, alphanumeric with underscores, hyphens, or dots)
- Enter an email address
- Choose a role (if role-based access control is available on your plan):
- Admin -- full access to all features and settings
- Editor -- can manage specific resources based on assigned permissions
- Viewer -- read-only access to domains, users, aliases, and logs
- For Editor accounts, select which permissions to grant:
- Domains, Users, Aliases, Services, Queue, DKIM, Backups
- Set a password (or click Generate for a strong random password)
- Must be at least 8 characters with uppercase, lowercase, number, and special character
- Confirm the password and click to create the account
Managing accounts
Each account in the list shows the username, role badge, email, creation date, and last login time.
Available actions per account:
- Edit -- change username, email, role, or permissions
- Change Password -- set a new password for any account
- Delete -- permanently remove the account (requires typing the account's username to confirm)
You cannot edit or delete your own account from this page (to prevent accidental lockout).
Account limits
Your license determines how many admin accounts you can create. The current count and limit are shown next to the Add Account button. If you've reached the limit, the button is disabled with a message explaining the restriction.
AI
The AI tab configures the Gemini API key used for AI-powered features.
Setting up the API key
- Get a Gemini API key from Google AI Studio
- Navigate to Settings > AI
- Paste your API key into the field
- Click Save Key
A green indicator confirms when a key is configured. The key is encrypted at rest and never exposed in API responses.
What the API key enables
- AI Log Analysis -- automatic analysis of mail server logs every 4 hours to detect issues and provide recommendations
- AI Email Screening (cloud mode) -- AI-powered spam detection using the Gemini API
Data privacy
The Gemini API does not use your data to train models. Data is retained by Google for up to 55 days solely for abuse monitoring and is not reviewed by humans unless flagged by automated safety systems.
License
The License tab shows your current plan, resource usage, and lets you activate or change your license key.
Current plan
The top of the tab shows your active plan tier (Community, Pro, Business, or Enterprise) with the license email and expiry date if applicable.
Resource usage
Three usage bars show how much of your plan's allocation you're using:
| Resource | What it tracks |
|---|---|
| Domains | Number of mail domains configured |
| Mailboxes | Number of user mailboxes created |
| Admin Accounts | Number of dashboard admin accounts |
Each bar shows current usage against the plan limit and turns yellow at 80% usage, red at 100%.
Activating a license
- Paste your license key into the text area
- Click Activate License
The dashboard validates the key, activates the associated plan features, and shows a confirmation. If the key is invalid or already activated on another server, you'll see an error message.
Changing or removing a license
- Change Key -- enter a new license key to switch plans
- Remove -- deactivates the current license and reverts to the Community plan. The license is freed for use on another server.
Removing a license
Removing your license immediately reverts the dashboard to the Community plan. Features and resource limits will be restricted to Community tier levels.
Plan comparison
A comparison table at the bottom shows what's included in each plan tier, with your current plan highlighted. This covers resource limits, administration features, security and compliance features, and scale and integration options.