From dfb8dd49c410a6bdc15226c3e5ec33ab00e30182 Mon Sep 17 00:00:00 2001 From: Giacomo Sanchietti Date: Thu, 16 Jul 2026 13:32:21 +0200 Subject: [PATCH] docs: document automatic IMAP action logging in NethServer 8 Dovecot logs IMAP actions (copy, move, expunge, flags) to the systemd journal by default, unlike NethServer 7 which required manual setup writing to /var/log/maillog. Includes Italian translation. Assisted-by: Claude Code:claude-sonnet-5 --- .../administrator-manual/applications/mail.md | 29 +++++++++++++++++++ .../administrator-manual/applications/mail.md | 29 +++++++++++++++++++ 2 files changed, 58 insertions(+) diff --git a/docs/administrator-manual/applications/mail.md b/docs/administrator-manual/applications/mail.md index 19bdf4be..859e425a 100644 --- a/docs/administrator-manual/applications/mail.md +++ b/docs/administrator-manual/applications/mail.md @@ -249,6 +249,35 @@ The `Message ID` value can be used to search the message in both [Rspamd web int If the delay reason is not resolved, and the message is not deleted, the message is returned to the sender after a configurable amount of time. Click the **Settings** button to modify it. See [Queue settings](#queue-settings-section) for details. +## IMAP actions logging {#imap-actions-logging} + +Every IMAP action performed by a mailbox (message copy, move, delete, flag change, etc.) is automatically logged by Dovecot, with no configuration required. + +:::note + +In NethServer 7, this behavior had to be enabled manually and log records were written to `/var/log/maillog`. In NethServer 8, IMAP action logging is active by default and records are sent to the systemd journal, alongside all other application logs. + +::: + +A typical log line looks like this: + + Jul 16 13:14:55 ns8n5 dovecot[800053]: imap(giacomo)<292043>: copy from junkmail: box=Trash, uid=150402, msgid=, from=Su <9srwu0x@top.hulsingcrm.com>, subject=Re: Vsol PON/Wireless CPE Manufacturer & FTTX Solution Provider, flags=(\Seen) + +The fields have the following meaning: + +- `imap()`: the mailbox owner performing the action. +- ``: the process ID of the IMAP session. +- ``: a unique identifier of the IMAP session. +- ``: the action performed, e.g. `copy`, `move`, `expunge`, `mailbox_delete`, `save`, or a flag change. +- `box`: the mailbox folder involved (source folder for `copy`/`move` actions). +- `uid`: the message UID within the mailbox. +- `msgid`: the message-id header of the email. +- `from`: the sender address of the message. +- `subject`: the message subject. +- `flags`: the IMAP flags currently set on the message (e.g. `\Seen`, `\Answered`, `\Deleted`). + +These records can be searched and viewed like any other application log, see [System logs](../configuration/log_server.md). + ## Relay {#relay-rules-section} When a message is received from another mail server (MTA), or from a mail user agent (MUA), Postfix determines if and how to relay it towards its final destination. This decision is typically based on relay authorization and the domain suffix of the recipient address. diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/applications/mail.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/applications/mail.md index f0ca22aa..5bcd360c 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/applications/mail.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/applications/mail.md @@ -249,6 +249,35 @@ Il valore `Message ID` può essere usato per cercare il messaggio sia nell'[inte Se il motivo del ritardo non viene risolto e il messaggio non viene eliminato, il messaggio viene restituito al mittente dopo un intervallo di tempo configurabile. Fai clic sul pulsante **Settings** per modificarlo. Vedi [Impostazioni della coda](#queue-settings-section) per i dettagli. +## Log delle azioni IMAP {#imap-actions-logging} + +Ogni azione IMAP eseguita su una casella di posta (copia, spostamento, eliminazione di un messaggio, modifica dei flag, ecc.) viene registrata automaticamente da Dovecot, senza bisogno di alcuna configurazione. + +:::note + +In NethServer 7, questo comportamento doveva essere abilitato manualmente e i log venivano scritti in `/var/log/maillog`. In NethServer 8, il log delle azioni IMAP è attivo per impostazione predefinita e i record vengono inviati al journal di systemd, insieme a tutti gli altri log delle applicazioni. + +::: + +Una tipica riga di log ha questo aspetto: + + Jul 16 13:14:55 ns8n5 dovecot[800053]: imap(giacomo)<292043>: copy from junkmail: box=Trash, uid=150402, msgid=, from=Su <9srwu0x@top.hulsingcrm.com>, subject=Re: Vsol PON/Wireless CPE Manufacturer & FTTX Solution Provider, flags=(\Seen) + +I campi hanno il seguente significato: + +- `imap()`: il proprietario della casella di posta che esegue l'azione. +- ``: l'ID del processo della sessione IMAP. +- ``: un identificativo univoco della sessione IMAP. +- ``: l'azione eseguita, per esempio `copy`, `move`, `expunge`, `mailbox_delete`, `save`, oppure una modifica dei flag. +- `box`: la cartella della casella di posta coinvolta (cartella di origine per le azioni `copy`/`move`). +- `uid`: l'UID del messaggio all'interno della casella di posta. +- `msgid`: l'intestazione message-id dell'email. +- `from`: l'indirizzo del mittente del messaggio. +- `subject`: l'oggetto del messaggio. +- `flags`: i flag IMAP attualmente impostati sul messaggio (per esempio `\Seen`, `\Answered`, `\Deleted`). + +Questi record possono essere cercati e visualizzati come qualsiasi altro log delle applicazioni, vedi [log di sistema](../configuration/log_server.md). + ## Relay {#relay-rules-section} Quando un messaggio viene ricevuto da un altro server di posta (MTA) o da un client di posta (MUA), Postfix determina se e come inoltrarlo verso la destinazione finale. Questa decisione si basa tipicamente sull'autorizzazione al relay e sul suffisso di dominio dell'indirizzo del destinatario.