| docs

Appearance

Postfix / Dovecot Logs ​

The Postfix / Dovecot Logs page provides detailed real-time logging for all email activity processed through the Postfix (SMTP) and Dovecot (IMAP/POP3) services. This page is essential for monitoring, debugging, and tracking mail flow on the server.

Postfix Dovecot Logs

Overview ​

URL: /admin/email-logs

This page shows a paginated table of log entries pulled from system-level email logs.

Each entry includes the following fields:

  • Time – Timestamp when the log was recorded.
  • Source – The service that generated the log (e.g., Postfix, Dovecot, or a specific IP address).
  • Level – The severity level of the log (e.g., INFO, WARNING, ERROR).
  • Message – The full log message string.

At the top of the log table, there are two dropdown filters and a search bar:

Filters ​

  • Source Filter
    Allows users to filter logs by the source (e.g., specific IPs, Postfix, or Dovecot).

    Source Filter

  • Level Filter
    Enables filtering by severity level: INFO, WARNING, ERROR.

    Level Filter

  • Date Filter
    A date range picker is available to filter logs by specific days or time ranges.

The search bar allows users to search through logs by Time, Source, and Level.

Pagination ​

Log entries are paginated for performance. Users can select how many results to display per page (e.g., 5, 10, 25, 50, All) using the Per Page dropdown, and navigate between pages using the paginator at the bottom.

  • Example:
    “Showing 1 to 10 of 7,124 results” with controls:
    1 2 3 ... 7124

View Log Details (Modal) ​

Clicking the View button (eye icon) next to any log entry opens a modal window with full details of the selected log.

The modal includes:

  • Created at – Exact timestamp.
  • Source – Service that generated the log.
  • Level – Log severity.
  • Full message – Complete raw log message, including protocol session details and system information.

View Email Log Modal

Truncate Logs ​

Located at the top-right of the table, the Truncate Logs button allows administrators to permanently delete all existing logs from the system.
This action clears the entire log database and cannot be undone. A confirmation prompt is displayed before logs are removed.

⚠️ Warning: Use this option carefully, as truncating logs will result in the loss of historical log data.

Use Case ​

This log interface is helpful for:

  • Troubleshooting email delivery issues.
  • Detecting failed logins or authentication problems.
  • Monitoring system performance or anomalies.
  • Verifying successful email transmissions.