yet another it blog

Postfix SMTP relay to SendGrid

SendGrid Logo

Postfix can be configured to relay outbound emails trough SendGrid service by adding few lines to postfix configuration.

First create API key in SendGrid service. Go to API keys, crate new API key and set access permission to “Restricted Access” and only allow “Mail send” as we wont be needing any other access rights.

Copy API key password for later use.

Edit postfix configuration file (i.e /etc/postfix/main.cf) and add following lines:

smtp_sasl_auth_enable = yes
smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd
smtp_sasl_security_options = noanonymous
smtp_sasl_tls_security_options = noanonymous
smtp_tls_security_level = encrypt
header_size_limit = 4096000
relayhost = [smtp.sendgrid.net]:587

Edit mynetworks line to include hosts or networks allowed to send emais trough postfix server.

mynetworks =,,

Also edit inet_interfaces from localhost to all.

inet_interfaces = all

Next we will create file for storing login information to SendGrid.

Create a file located at /etc/postfix/ sasl_passwd and type in:

[smtp.sendgrid.net]:587 apikey:yourapikeypasswordgoeshere

Secure file by limiting access rights: sudo chmod 600 /etc/postfix/sasl_passwd

Postmap file by running: sudo postmap /etc/postfix/sasl_passwd

Now restart postfix sudo service postfix restart

Thats it now you able to relay trough SendGrid service.

If you reveive error: SASL authentication failed; cannot authenticate to server smtp.sendgrid.net[x.x.x.x]: no mechanism available then you are likely missing necessary modules.

On CentOS/RedHat run: yum install cyrus-sasl-plain

Debian/Ubuntu: apt-get install libsasl2-modules

Remember to activate DKIM and whitelist necessary IP addresses in SendGrid.

1 thought on “Postfix SMTP relay to SendGrid

Leave a Reply

Your email address will not be published.