Postfix Queue Management

Goal: To find which mails are stuck in mail queue and why?

If emails are getting delayed, its better to inspect postfix mail queues, coupled with postfix mail log.

Status/Shape of Mail Queue

Postfix maintains different queues for different  and  deferred queues are of our interest.

Ideally, we should never have a mail in deferred queue.

qshape command will show shape of active mail queue by default. Ideally it should be as close as to empty since postfix sends email instantly!


Sample Outputs:

       T  5 10 20 40 80 160 320 640 1280 1280+
TOTAL  0  0  0  0  0  0   0   0   0    0     0

If a mail is deferred, it will be moved to deferred queue.

Running following command will show you the number of deferred emails for each domains…

qshape deferred

Sample Output:

               T  5 10 20 40 80 160 320 640 1280 1280+
        TOTAL  5  0  0  0  0  0   0   0   0    0     5  4  0  0  0  0  0   0   0   0    0     4  1  0  0  0  0  0   0   0   0    0     1

If you see mails to one or more domain only being deferred, check if you can connect to those servers from your network.

Analyze mails in queue

Dump entire mail queue

You can use either mailq or postqueue -pcommand. They will show an output like below:

-Queue ID- --Size-- ----Arrival Time---- -Sender/Recipient-------
2FC8824D24    10588 Thu Sep 27 14:52:41
(connect to[]:25: Connection timed out)
-- 16 Kbytes in 2 Requests.

You get dump for all emails from all mail queues including active & deferred queue.

Read an email from mail queue

Every message in queue has a unique id. You can read message in queue using a command like:

postcat -q  DA80E24A0A


postcat -qv  DA80E24A0A

It will display your emails with headers and some more info. Using ‘v’ will display extra information.

Attempt to send an email from mail queue

Its better to first open postfix log using something like below:

tail -f /var/log/mail.{err,log}

Then you can identify a stuck mail and attempt to send it by using:

postqueue -i DA80E24A0A

If that mail gets stuck again, check log tab to find reason.

Once you fix issue, you can attempt to send that mail again. Mail ID inside queue remains same even if mail gets deferred again and again.

Attempt to send all email from mail queue

Once you rectify issue and confident about delivery, you may try flushing entire queue immediately using:

postqueue -f

Deleting Pending mails from queue

Sometimes you realize that all stuck emails are being sent to non-existent emails. Most likely emails generated because of some spam activity.

Delete All Deferred Mails

In that case, you can simply delete all queued mails using:

postsuper -d ALL deferred

Delete a single mail from queue

If you want to just delete one mail, you can try:

postsuper -d DA80E24A0A

Delete mails to a specific mail address

You need to some work here as postfix has no direct command for this.

Following sample is taken from postsuper man page:

mailq | tail -n +2 | grep -v '^ *(' | awk  'BEGIN { RS = "" } { if ($8 == "USER@EXAMPLE.COM" && $9 == "") print $1 } ' | tr -d '*!' | postsuper -d -

Just replace USER@EXAMPLE.COM with receiver email address.

$8 will contain recipient1 email-address, $9 will contain recipient2 email-address.

If you want to filter from-email address, use $7 variable.

Discuss your project
with our experts

No obligation. Limited slots.

Contact Form Business Enquiry

"*" indicates required fields

Please attach any RFP, project specification, or document that you would like to share.
Drop files here or
Max. file size: 5 GB.
    This field is for validation purposes and should be left unchanged.