How to debug Postfix?

If you’ve read about my tutorial on setting up Postfix, you should be able to send and receive emails now. But life never goes smooth always.  You may encounter this or that problem in using the email system. To solve problems quickly, you need some tips of debugging postfix. The log file (/var/log/maillog) is the main source to find useful information about problems. You can read this article on analyzing the log file. This is an in-depth article which is much better than the lengthy/tedious/not accurate  Q&As on stackoverflow. To get more information, you can add the following lines in

Postfix will generate more logs when it handles emails with the peer(xx.xx.xx.xx is the ip address of the peer). You can send an email from the ip address you specify as the debug_peer_list parameter, then read /var/log/maillog to see what happened. If you’ve known which specific daemon is making trouble, you can turn the verbose mode on for that daemon in For example, the following will make smtpd to generate even more logs in /var/log/maillog.

Here are some tips on reading the log file:

  1. First, find the line “connect from…” is where email receiving/relaying begins.
  2. Second, the lines containing “>”  are where postfix sends messages to the peer. You can see the messages postfix sends in those lines.
  3. Third, the lines containing “<” are where posfix receives messages from the peer. Also you can check what messages are being received on those lines.
  4. Fourth, the lines containing “>>>…<<<” are where postfix checks the rules in For example, the following line indicates postfix is verifying the rule:smtpd_recipient_restrictions =xxxx

>>> START Recipient address RESTRICTIONS <<<

Finally, I recommend you read this official debug guide .

Analyzing the mail log is sometimes an interesting work. For example, if you use postfix to send massive emails, your ip may get blacklisted. How do you know your Ip has been blacklisted? You can check it in the mail log.  The following line in /var/log/maillog indicates the sending ip has already been on the black list.

Mar  1 16:08:18 mailserver postfix/smtp[997]: 5B3B765EBD8: to=<>,[]:25, delay=118832, delays=118832/0.16/32/0, dsn=4.0.0, status=deferred (host[] refused to talk to me: 554 bizsmtp IB233. Connection refused. xx.xx.xx.xx has a poor reputation on Cloudmark Sender Intelligence (CSI). Please visit to request a delisting.)

The line says: on Mar  1 16:08:18, on host mailserver, the service postfix, the process smtp(the process id 997), was delivering an email destined to, the next-stop smtp server (the relay) is, the delay of this email after it is received by postfix is 118832, the delays in various modules of postfix(smtpd, cleanup, qmgr and smtp) are 118832/0.16/32/0. The next-stop smtp server replies with  code 4.0.0 and an message saying the sending ip is blacklisted,and refuses to receive this email. So the email is now in deferred status.

We can find other sending failures in the mail log:

Mar  1 16:35:53 mailserver postfix/smtp[959]: 1F9ED12EDC0: to=<>,[]:25, delay=112114, delays=112173/0.12/20/20, dsn=5.0.0, status=bounced (host[] said: 550-Verification failed for <> 550-The mail server could not deliver mail to  The account or domain may not exist, they may be blacklisted, or missing the proper dns entries. 550 Sender verify failed (in reply to RCPT TO command))

Here, you can see the email is rejected after our postfix sends the “RCPT TO” command to the peer smtp server. Why is the email rejected? Because the domain of the sender email does not exist. If you are confused about the difference between bounced email and deferred email, here you can find the answer. An email gets bounced because it has non-fixable error(in this case, the sender email is wrong). An email is deferred because of temporary issue(in our case, the sending ip is blacklisted). The common reasons why email is deferred are:

  • recipient address does not exists(no route to host)
  • recipient  host exists but can not connect(Connection timed out)
  •  Sender address rejected: Domain not found
  •  Client host rejected: cannot find your hostname(PTR not set)
  • sender ip on blacklist
  • Helo command rejected: Host not found
  • too many connections from sending ip
  • Name service error for name=recipient domain type=MX: Host not found, try again
  •  server has reached its limit for processing requests from your host
  • Sender address could not be verified


Postfix will continue to deliver the deferred emails until success or timed out. Postfix won’t waste time to send bounced email repeatedly as it is doomed to fail.

Occasionally, you may suspect somebody else is using your email system to send bulk spam emails. You can verify this by checking the mail log:

cat /var/log/maillog | grep “connect from ”

This will list all ips trying to connect to your email server to send emails. You should notice the time stamp in front of each line. If there are large number of connections in a short period, your email server is most likely abused by malicious guys.

How to find all successfully received incoming emails?

cat /var/log/maillog |grep “relay=local” |grep “status=sent”

How to find all successfully delivered outgoing emails?

cat /var/log/maillog |grep -v “relay=local” |grep “relay=” |grep “status=sent”

How to find all emails that are failed to deliver?

cat /var/log/maillog |grep -v “status=sent” |grep “relay=”

How to find all internal emails that are not delivered successfully?

cat /var/log/maillog |grep -v “status=sent” |grep “relay=local”

How to find all outgoing emails that are failed to deliver?

cat /var/log/maillog |grep -v “status=sent” |grep -v “relay=local” |grep “relay=”

Postfix maintains different queues for emails. The current ready-t0-go emails go to /var/spool/postfix/active; the deferred emails go to /var/spool/postfix/deferred. To delete all queued emails including active and deferred ones, use “postsuper -d ALL”; to just delete deferred emails from queue, use “postsuper -d ALL deferred”. To see all emails in queues, use “mailq” or “postqueue -p” ( Postfix has other queues in /var/spool/postfix/ such as incoming queue, hold queue,maildrop queue, etc. This post details the usage of these queues. But I still have questions about the exact aim of these queues, for example, what is the difference between incoming queue and maildrop queue? How to clean up the emails in /var/spool/postfix/maildrop?

Posted in tips of hosting