Checking SPF on incoming mail with Postfix

Something I’ve been wanting to add to my mail server for a while is Sender Policy Framework (SPF) checking on incoming mail. For anyone who isn’t familiar with SPF, it enables the owner of a domain to specify which hosts are allowed to send mail for that domain by adding a TXT record. Other mail servers can lookup this record via DNS and accept or reject incoming mail depending on whether the mail comes from an authorised host. SPF isn’t perfect, and there are a few known issues, but it is one of a collection of tools that a sysadmin can deploy to reduce incoming spam.

I use Postfix on all my mail servers and fortunately a lot of the work has been done by other people. On Debian you can add SPF checking on incoming mail in four steps (these should work for Ubuntu as well).

Step 1: Install the postfix-policyd-spf-python package.

Step 2: Add the following line to /etc/postfix/

policy-spf  unix  -       n       n       -       -       spawn
  user=nobody argv=/usr/bin/policyd-spf

Step 3: Add the following line to /etc/postfix/

policy-spf_time_limit = 3600s

This timeout allows for a DNS lookup of the SPF record.

Step 4: Add the following line to smtpd_relay_restrictions as the last option before the final permit

check_policy_service unix:private/policy-spf

The reason for leaving the SPF check until last is that it involves a DNS lookup, which is a relatively expensive operation compared to other checks such as reject_unauth_destination.

To check whether SPF is configured correctly, search your mail log for policyd-spf. Messages which are rejected due to an SPF failure will look like this:

Jan 19 11:55:58 davros policyd-spf[23964]: Fail; identity=mailfrom; client-ip=; helo=myhost;;

Jan 19 11:55:58 davros postfix/smtpd[23957]: NOQUEUE: reject: RCPT from unknown[]: 550 5.7.1 <>: Recipient address rejected: Message rejected due to: SPF fail - not authorized. Please see;;ip=;; from=<> to=<> proto=ESMTP helo=


  1. seb

    il est marrant de voir que le paquet postfix-policyd-spf-python est pas très à jour vu que n’existe plus et a été remplacé par a priori. Par ailleurs le rejet reste assez violent, y a t’il une façon de configurer pour recevoir le mail quitte à le placer dans un dossier particulier ?

  2. Sisko214

    Should be possible to solve with editing /etc/postfix-policyd-spf-python/policyd-spf.conf and adding an entry like:

    Reason_Message = Your email {rejectdefer} is been rejected due to a bad SPF record: {spf}.\n Please contact your Mail or Dns administrator in order to fix it. Thanks.

    But i did not checked if works yet.

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.