How to Set Up Postfix SMTP Relay on CentOS with Mailjet

This tutorial is going to show you how to set up Postfix SMTP relay with Mailjet on CentOS/RHEL. Postfix is a popular open-source SMTP server. Previously I wrote an article how to easily set up a full-blown email server on CentOS/RHEL with Modoboa, which helped a lot of readers run their own email server.

However, some readers told me that port 25 is blocked by hosting provider or ISP as a way to control email spam, so they couldn’t send email. Vultr would unblock port 25 if you ask them to, and ScalaHosting doesn’t block port 25 at all, so I recommend using ScalaHosting VPS. Some other hosting providers or ISPs like DigitalOcean would refuse to unblock port 25.

SMTP Relay To The Rescue

You can bypass port 25 and send emails to outside world with SMTP relay because it uses port 587. With SMTP relay, your own email server doesn’t directly send email to the destination email address. Instead, there’s an intermediate mail server, otherwise known as smart host or relay host , that sends emails on your behalf. Your email server communicates with relay host on port 587, then the relay host talks with the recipient’s mail server on port 25.

SMTP relay can also help you get around anti-spam blacklists, if your IP address is blacklisted for whatever reason. The recipient’s mail server checks the relay host’s IP address against public anti-spam blacklists, instead of your server IP address and because SMTP relay services maintain good IP reputation, so your emails can get through IP blacklists.

Using Mailjet To Send 200 Emails Per Day For Free

There are several email service providers (ESP) that can act as relay host. Some charge a little fee, some offer free quotas every month. In this article, I’d like to show you how to use Mailjet, which is an email service provider that allows you to send 200 emails per day for free.

The nice thing about Mailjet is that it doesn’t require you to enter your credit card details when you use the free SMTP relay service. There are other ESPs that offer free quota every month but requires you to enter credit card details. (I know how frustrated it can be when you don’t have a credit card.) Mailjet is also easier to set up, compared to other ESPs.

Create an account at mailjet.com. Then on the dashboard, you can see the 3 things that you need to do.

  • Setting up SMTP
  • Managing sender addresses
  • setting up domain authentication (SPF and DKIM)

postfix smtp relay

Step 1: Setting up Postfix SMTP Relay on CentOS/RHEL

First, let’s install Postfix SMTP server on CentOS/RHEL with the following command. If Postfix is already running on your server, then skip installing Postfix.

sudo dnf install postfix

You need to install the following two packages in order to use SMTP relay.

sudo dnf install cyrus-sasl-plain cyrus-sasl-md5

By default, the relayhost parameter in Postfix is not set, as can be seen with:

postconf relayhost

Output:

relayhost =

You need to get the relay host address from your mailjet account. In mailjet dashboard, click setup my SMTP.

set up postfix smtp relay with mailjet

You will see the SMTP server address and SMTP credentials.

postfix bypass port 25

Run the following command to set the value of relayhost to in-v3.mailjet.com:587.

sudo postconf -e "relayhost = in-v3.mailjet.com:587"

Edit the Postfix main configuration file with a command-line text editor, such as Nano.

sudo nano /etc/postfix/main.cf

Scroll down the end of the file. (In Nano, you can achieve that by pressing Ctrl+W, then Ctrl+V.)  Add the following lines to the end of this file.

# outbound relay configurations
smtp_sasl_auth_enable = yes
smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd
smtp_sasl_security_options = noanonymous
header_size_limit = 4096000

Save and close the file. To save a file in Nano text editor, press Ctrl+O, then press Enter to confirm. To exit, press Ctrl+X.

Then create the /etc/postfix/sasl_passwd file.

sudo nano /etc/postfix/sasl_passwd

Add the SMTP relay host and SMTP credentials to this file like below. Replace api-key and secret-key with your real Mailjet API key and secret key.

in-v3.mailjet.com:587  api-key:secret-key

Save and close the file. Then create the corresponding hash db file with postmap.

sudo postmap /etc/postfix/sasl_passwd

Now you should have a file /etc/postfix/sasl_passwd.db. Restart Postfix for the changes to take effect.

sudo systemctl restart postfix

By default, sasl_passwd and sasl_passwd.db file can be read by any user on the server.  Change the permission to 600 so only root can read and write to these two files.

sudo chmod 0600 /etc/postfix/sasl_passwd /etc/postfix/sasl_passwd.db

From now on, Postfix will send emails via mailjet.

Step 2: Adding Sender Addresses

You need to add sender domain or sender address in order to send email via mailjet. In mailjet dashboard, click manage sender addresses. You can validate your entire domain or specific email addresses.

validate sender domain or sender address

Step 3: Setting up Domain Authentication

In this step, we need to set up SPF and DKIM record, which is strongly recommended if you want your emails to land in recipient’s inbox rather than spam folder.

  • SPF: Sender Policy Framework. This is a DNS record that specifies what IP addresses are allowed to send email from your domain.
  • DKIM: DomainKeys Identified Mail. Mailjet will digitally sign your emails with a private key. The DKIM record contains a public key that allows recipient’s email server to verify the signature.

In mailjet dashboard, click setup domain authentication. By default, SPF status and DKIM status are both in error. Click manage button and follow the instructions to add SPF and DKIM records.

smtp relay set up SPF and DKIM

After SPF and DKIM records are created, wait a few moments and refresh the mailjet web page. Your new DNS records can take some time to propagate on the Internet, depending on your DNS hosting service. If SPF and DKIM records are set up correctly and propagation is complete, mailjet would tell you that SPF and DKIM record are good.

mailjet spf dkim

Sending Test Email

Now we can send a test email with mailx command like below.

sudo dnf install mailx

echo "this is a test email." | mailx -r from-address -s hello to-address

You can also send a test email from your webmail client or desktop mail client. It is also a good idea to test your email score at https://www.mail-tester.com. As you can see, I got a perfect score.

spam test result

Troubleshooting

If your email wasn’t delivered and you found the following message in the mail log (/var/log/maillog),

Relay access denied (in reply to RCPT TO command))

then you might need to edit the /etc/postfix/sasl_passwd file and remove the port number after the hostname like below.

in-v3.mailjet.com    api-key:secret-key

Save and close the file. Then build the index file again.

sudo postmap /etc/postfix/sasl_passwd

Restart Postfix for the changes to take effect.

sudo systemctl restart postfix

Now you can flush the email queue (attempt to deliver the previous emails).

sudo postqueue -f

Adding Additional Domains

If you set up a mail server on a new machine for a new domain name, and you want to set up SMTP relay for this new domain name, then follow the same steps:

  • Configure Postfix SMTP relay settings
  • Validate the new domain name in Mailjet dashboard
  • Set up SPF and DKIM verifications

Wrapping Up

That’s it! I hope this tutorial helped you set up Postfix SMTP relay on CentOS/RHEL to bypass port 25 or IP blacklists. As always, if you found this post useful, then subscribe to our free newsletter to get more tips and tricks. Take care.

Rate this tutorial
[Total: 0 Average: 0]

7 Responses to “How to Set Up Postfix SMTP Relay on CentOS with Mailjet

  • This is exactly what I was looking for. Thanks for posting this.

  • When I found the port 25 is blocked in my host, I felt desperate.
    Then I found your article, I felt I saw a light in darkness.
    However, after I tried both 587 and 465, I felt desperate again.
    I can see the mail is sent out, but I don’t know why mailjet cannot get it.

  • Finally, I get it work now on 587. The problem was in the Mailjet side.

  • Hi Xiao… i have this problems when try to send the email with mailjet…

    validating in-v3.mailjet.com/CNAME: no valid signature found
    validating in.mailjet.com/MX: no valid signature found
    validating in.mailjet.com/A: no valid signature found

    do you have any idea? thanks a lot.

  • Dhanuka
    3 years ago

    Thank you soo much for writing this article! You literally saved my life. I have been trying to setup smtp relay on postfix using different configurations for weeks and non of them worked as intended. This is the only tutorial which was able to achieve exactly what I was looking for..

    Mailjet has mentioned to add
    @example.com apikey:secretkey
    [email protected] apikey2:secretkey2

    In /etc/postfix/sasl_passwd, provide credentials for each address listed in

    So I added

    *@mydomain.com andmyapikey:mysecretkey
    [email protected] myapikey:mysecretkey

    non of them worked

    but in your example you added
    in-v3.mailjet.com api-key:secret-key ( In /etc/postfix/sasl_passwd)

    I was wondering If we have
    sender_dependent_relayhost_maps = hash:/etc/postfix/sender_relay
    in /etc/postfix/main.cf

    How should we setup our /etc/postfix/sasl_passwd file?

    Thank you so much!~

  • Rodrigo
    2 years ago

    What is the purpose of a relay server? If MailJet can’t send more emails, will my current email server start sending up coming emails?

Leave a Comment

  • Comments with links are moderated by admin before published.
  • Your email address will not be published.
  • Use <pre> ... </pre> HTML tag to quote the output from your terminal/console.
  • Please use the community (https://community.linuxbabe.com) for questions unrelated to this article.
  • I don't have time to answer every question. Making a donation would incentivize me to spend more time answering questions.

The maximum upload file size: 2 MB. You can upload: image. Links to YouTube, Facebook, Twitter and other services inserted in the comment text will be automatically embedded. Drop file here