When an email fails to send, it ends up in one of two queues within Postfix: pending and deferred.<\/p>\n\n\n\n
The pending queue includes all messages you’ve submitted to Postfix that have yet to be sent out and handed off to the recipient server. The deferred mail queue holds all messages that have soft-failed and need to be retried (temporary failure).<\/p>\n\n\n\n
Postfix will try resending messages from the deferred queue at set intervals. This is set to 5 minutes by default, but what you may not know is that this process is fully configurable.<\/p>\n\n\n\n
Don’t worry, you’re not alone. In our experience, most users don’t know how to review their message queues. That’s why we have written this handy primer. By entering any of the following commands, you can easily inspect and manage your Postfix message queues.<\/p>\n\n\n\n
If you simply wish to review your message queues, enter:<\/p>\n\n\n\n
Alternatively, if you need to save the output to a text file, run:<\/p>\n\n\n\n Either of these commands will show the sender, recipients, and ID \u2013 not the message itself<\/strong>. Although the ID will help you track down individual messages.<\/p>\n\n\n\n Message IDs are available form the message queue. So, to view a message with the ID XXXXXXX<\/em>, you would enter:<\/p>\n\n\n\n Or, to save it in a file, enter:<\/p>\n\n\n\n postcat -vq XXXXXXXXXX > emailXXXXXXXXXX.txt<\/em><\/p>\n\n\n\n A useful feature for web servers is to enable mail.add_x_header = on<\/em> in the Postfix configuration.<\/p>\n\n\n\n This will add a header to all outgoing email messages showing the script and user that generated each message. Once enabled this will then add the following extra header to message:<\/p>\n\n\n\n X-PHP-Originating-Script: 1001:spamEmailer.php<\/em><\/p>\n\n\n\n In this example, 1001<\/em> is the user ID and the spamEmailer.php<\/em> is the script sending the message. This allows you to quickly track down the source of any spam messages sent by your server.<\/p>\n\n\n\n With these commands, you should be able to review your mail queue. You can then ensure intended messages are getting through and are not being rejected.<\/p>\n\n\n\n Now that you’re familiar with the commands that will allow you to review your mail queues, let’s look at how you can delete messages from your backlog.<\/p>\n\n\n\n By entering the right command, you can force Postfix to immediately attempt to send all queued messages. There are two to choose from:<\/p>\n\n\n\n postqueue -f<\/em> A similar command will allow you to delete all queued messages in Postfix. This includes messages from both the pending and deferred queues:<\/p>\n\n\n\n postsuper -d ALL<\/em><\/p>\n\n\n\n So, if you needed to delete all queued messages to or from the domain called spamers.com, you would enter:<\/p>\n\n\n\n .\/postfix-delete.pl spamers.com<\/em><\/p>\n\n\n\n Similarly, if you wanted to delete all queued messages that contain the word “spam” in the e-mail address, you’d use the following command: To delete all messages from the deferred queue specifically (i.e. only the ones the system intends to retry later), enter:<\/p>\n\n\n\n postsuper -d ALL deferred<\/em><\/p>\n\n\n\n You can also delete specific messages from your mail queues. This is not something that is natively included with the standard Postfix tools, but can be done with a bit of Perl scripting.<\/p>\n\n\n\n NB: This Perl script appears to be free; it’s all over the Internet. That being said, we couldn’t find out where it originated or who wrote it. Our thanks go out to them either way!<\/p>\n\n\n\n Credits: This post was originally written by Jon Totham for a now-deleted domain. We have restored and enhanced the article to preserve its valuable content.<\/p>\n","protected":false},"excerpt":{"rendered":" When an email fails to send, it ends up in one of two queues within Postfix: pending and deferred. The pending queue includes all messages you’ve submitted to Postfix that have yet to be sent out and handed off to the recipient server. The deferred mail queue holds all messages that have soft-failed and need […]<\/p>\n","protected":false},"author":1,"featured_media":11,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[3],"tags":[5,4],"class_list":["post-1","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-mail-server","tag-mail-server","tag-postfix"],"jetpack_featured_media_url":"https:\/\/lokka.ro\/blog\/wp-content\/uploads\/2024\/05\/Mailboxes_resized.jpg","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/lokka.ro\/blog\/wp-json\/wp\/v2\/posts\/1","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lokka.ro\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lokka.ro\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lokka.ro\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lokka.ro\/blog\/wp-json\/wp\/v2\/comments?post=1"}],"version-history":[{"count":4,"href":"https:\/\/lokka.ro\/blog\/wp-json\/wp\/v2\/posts\/1\/revisions"}],"predecessor-version":[{"id":13,"href":"https:\/\/lokka.ro\/blog\/wp-json\/wp\/v2\/posts\/1\/revisions\/13"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/lokka.ro\/blog\/wp-json\/wp\/v2\/media\/11"}],"wp:attachment":[{"href":"https:\/\/lokka.ro\/blog\/wp-json\/wp\/v2\/media?parent=1"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lokka.ro\/blog\/wp-json\/wp\/v2\/categories?post=1"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lokka.ro\/blog\/wp-json\/wp\/v2\/tags?post=1"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}mailq<\/code><\/em>
orpostqueue -p<\/code><\/em><\/p>\n\n\n\nmailq > mailqueue.txt<\/code><\/em>
orpostqueue -p > mailqueue.txt<\/code><\/em><\/p>\n\n\n\n2) View message (contents, header, and body) in your Postfix queue<\/strong><\/h3>\n\n\n\n
postcat -vq XXXXXXXXXX<\/code><\/em><\/p>\n\n\n\nHow to delete queued mail from the mail queue<\/h2>\n\n\n\n
1) Tell Postfix to process the queue now<\/h3>\n\n\n\n
or
postfix flush<\/em><\/p>\n\n\n\n2) Delete queued mail<\/h3>\n\n\n\n
.\/postfix-delete.pl spam<\/em><\/p>\n\n\n\n3) Selectively delete mail from the queue<\/h3>\n\n\n\n
postfix-delete.pl:<\/h5>\n\n\n\n
$REGEXP = shift || die \"no email-adress given (regexp-style, e.g. bl.*\\@gmail.com)!\";\n\n@data = qx<\/usr\/sbin\/postqueue -p>;\nfor (@data) {\n if (\/^(\\w+)(\\*|\\!)?\\s\/) {\n $queue_id = $1;\n }\n if($queue_id) {\n if (\/$REGEXP\/i) {\n $Q{$queue_id} = 1;\n $queue_id = \"\";\n }\n }\n}\n\n#open(POSTSUPER,\"|cat\") || die \"couldn't open postsuper\" ;\nopen(POSTSUPER,\"|postsuper -d -\") || die \"couldn't open postsuper\" ;\n\nforeach (keys %Q) {\n print POSTSUPER \"$_\\n\";\n};\nclose(POSTSUPER);<\/code><\/pre>\n\n\n\n
\n\n\n\n