Skip to main content
WisMail

Administer your mail server

Web administration is where you run the whole server from a browser. This guide walks through the screens you will use every week and the settings that protect the administration itself. Overview of the tool: web administration.

Open https://<host-name>:4040/admin and log in with the administrator account created in the setup wizard (install guide). The interface comes in English, Vietnamese, Chinese and Russian; change the language from the shell menu. The menu is grouped into Accounts, Status and Configuration.

Users, aliases and groups

Web administration Users list with quota, status and two-factor columns
  • Accounts, Users: create users, set or reset passwords, set a disk quota, disable or enable a user. User templates give new users consistent defaults.
  • Bulk import: import many users from a CSV file instead of typing them. See migration for a typical rollout.
  • Directory users: if a domain is mapped to LDAP or Active Directory, those users are listed here read-only (LDAP guide).
  • Aliases are extra addresses for a user, and mailing lists send one address to many people (info@, sales@). Groups collect users for access rules and sharing.

The number of enabled users cannot exceed the number in your license: adding or enabling more is refused until a new key is installed (license activation).

Domains and quotas

Web administration Domains list and domain settings

Under Configuration, Domains add mail domains and domain aliases, set quotas and turn on DKIM signing (see DNS setup). A mailbox over its quota is handled safely: incoming SMTP mail is deferred with a temporary error rather than lost, and IMAP refuses to append more messages.

Groups, resources and mailing lists

Web administration Groups page

Under Accounts you also manage Resources: rooms and equipment that accept or decline booking requests and detect conflicts, so a room cannot be double-booked. See public folders and resources.

Queue and logs

  • Status, Message Queue shows messages waiting for delivery. Select a message to retry it now or remove it. This is the first place to look when mail does not leave (SMTP relay guide).
  • Logs lets you view and filter the Mail, Error, Warning, Security, Spam, Operations, Config, Debug and Audit logs in the browser. On the server the files are in /opt/wismail/store/logs/.
  • Status, Dashboard and Statistics show activity, and Active Connections shows who is connected now.

Access policy and brute-force protection

Web administration User Access Policies: services allowed per IP address group and time range
  • Configuration, Definitions holds IP Address Groups and Time Ranges.
  • User Access Policies use them to decide who may use which service, from which network and when. For example allow web administration only from your office network.
  • Brute-force protection under Security temporarily locks addresses that repeat failed logins.

Two-factor authentication

Users can protect their account with a time-based one-time code (TOTP) from an authenticator app. Because IMAP, POP3 and SMTP clients cannot ask for a code, users create app passwords for those clients. Two-factor is managed from the user list and from the user's webmail settings.

Mobile devices

On a user's Devices tab you see the ActiveSync devices that sync that account, and you can wipe a device remotely when it is lost or stolen. Setup for devices: features: ActiveSync.

Anti-spam, anti-virus and message rules

Set spam scores, ClamAV scanning, the attachment filter and global message rules in Content Filter and Message Filters. Step by step: anti-spam and anti-virus guide.

Certificates and backup

Issue a Let's Encrypt certificate or import your own (SSL guide). Schedule backups and copy them off the server (backup guide); remember that a restore is manual.

Administration settings

Open Configuration, Administration Settings for the settings that protect administration itself:

  • Built-in administrator account: tick Enable built-in administrator account to get an extra administration login with its own name and password (at least 6 characters). It is only for administration: it does not use up a license and has no mailbox.
  • Remote administration: tick Allow administration from remote host and, to be safe, limit it Only from this IP address group, for example your office network. Also close port 4040 in the firewall to everyone else (install guide, step 4).

Command-line operations

systemctl status wismail       # service status
sudo systemctl restart wismail
journalctl -u wismail -e       # service log
sudo /opt/wismail/wismail-tool license show         # show the license key

Forgotten administrator password: stop the service and use the passwd command of /opt/wismail/wismail-tool.

Next steps