Logs
View, search, and filter mail server logs in real time with automatic updates and log export.
The Logs page provides a real-time view of your mail server logs. It shows entries from Postfix, Dovecot, OpenDKIM, SpamAssassin, and other mail services, with filtering by log level and service source.
Log viewer
The log viewer displays entries in chronological order with each line showing:
[timestamp] [LEVEL] [source] message
Entries are color-coded by severity:
| Level | Color | Meaning |
|---|---|---|
| ERROR | Red | Something failed and needs attention |
| WARNING | Orange | A potential issue that may need investigation |
| INFO | Green | Normal operational messages |
| DEBUG | Blue | Detailed diagnostic information |
Real-time updates
The log viewer polls for new entries every 5 seconds automatically. A green dot next to "Polling every 5s" in the stats bar confirms live updates are active. You always see the most recent log activity without manually refreshing.
Stats bar
A summary bar above the log viewer shows:
- Total entries -- the number of log lines currently loaded
- Errors -- count of error-level entries (red)
- Warnings -- count of warning-level entries (orange)
Filtering
Two dropdown filters help you narrow down the logs:
Log level filter
- All Levels -- show everything
- Error only -- only error messages
- Warning & above -- warnings and errors
- Info & above -- info, warnings, and errors
- Debug & above -- everything including debug messages
Service filter
Filter by the service that generated the log entry. The dropdown is populated dynamically based on what services have logged entries (e.g., postfix/smtp, postfix/smtpd, dovecot, opendkim, spamd).
Searching
The search bar filters log entries by keyword across the message, source, and timestamp fields. Search results update instantly as you type.
Exporting logs
Click Export to download the currently filtered log entries as a .log text file. The filename includes the current date and any active filters (e.g., ceymail-logs-2026-03-14-error.log). Only the entries matching your current filters and search are exported.
Clearing logs
The log viewer displays up to 100 entries at a time, showing the most recent activity from the mail log.
Click Clear to remove all entries from the log viewer display. This clears the in-memory display only -- it does not delete log files from the server. New entries will continue to appear as the server generates them.