[pmg-devel] [PATCH pmg-docs 1/2] add minimal queue administration docs

Stoiko Ivanov s.ivanov at proxmox.com
Mon May 25 19:59:18 CEST 2020

describe the buttons and their functions with the most common usage.

Signed-off-by: Stoiko Ivanov <s.ivanov at proxmox.com>
 pmg-administration.adoc | 36 +++++++++++++++++++++++++++++++++++-
 1 file changed, 35 insertions(+), 1 deletion(-)

diff --git a/pmg-administration.adoc b/pmg-administration.adoc
index 74f8ba1..3f6be64 100644
--- a/pmg-administration.adoc
+++ b/pmg-administration.adoc
@@ -178,4 +178,38 @@ the status is shown as 'queued/accepted' instead of 'accepted/<status>'.
 Postfix Queue Administration
+Mail-queues are one of the central concepts of the SMTP protocol. Once a
+mailserver accepts a mail for further processing it saves it to a queue.
+After the mail is either relayed to another system, stored locally
+or discarded it is deleted from the local mail-queue.
+If immediate processing is not possible, for example because a downstream
+mailserver is not reachable, the mail remains on the queue for later
+The Queue Administration view provides a succinct overview, as generated by
+the 'qshape (1)' utility, about the current state of the postfix mail-queue.
+It shows mails for which domains were not delivered, and how long they have
+been queued.
+The three Action Buttons on top provide the most common queue operations:
+'Flush Queue'::
+Attempt to deliver all currently queued mail, for example if a downstream
+server has become available again.
+'Delete All Messages'::
+Delete all currently queued mail, for example if the queue contains only spam.
+Attempt to deliver all currently queued mail.
+'Discard address verification database'::
+Clear the recipient verification cache.
+In the 'Deferred Mail' tab you can filter and examine deferred mail in more
+detail by looking at the headers.

More information about the pmg-devel mailing list