Exim 4 SMTP Integration Guide

Prerequisites

You need to complete these given prerequisites, you can skip the step if you have already completed.

Sign up for a Mailazy account.
Complete Domain Authentication.
Generate the Mailazy Access Key

Integrate Mailazy with Exim 4

The following configuration file, which can be found at /etc/exim4/update-exim4.conf.conf, was pulled from Ubuntu Server 10.4 and is for example purposes only:

dc_eximconfig_configtype='smarthost'
dc_other_hostnames=''
dc_local_interfaces='127.0.0.1'
dc_readhost='your.server.name'
dc_relay_domains=''
dc_minimaldns='false'
dc_relay_nets=''
dc_smarthost='smtp.mailazy.com::587'

CFILEMODE='644'

dc_use_split_config='false'
dc_hide_mailname='true'
dc_mailname_in_oh='true'

Enable TLS support in /etc/exim4/exim4.conf.localmacros.

If this file does not exist, you will need to create it:

MAIN_TLS_ENABLE =  1

Enter credentials that will allow Exim to access Mailazy in /etc/exim4/passwd.client:

Note that you must use an API key to authenticate. Do this by setting your username to 'apikey' and your password to your API key's actual value (the string provided by Twilio Mailazy when you created the key).

*:mailazy_apikey:mailazy_secret

Once you have completed and saved all changes to Exim's configuration files, you will need to restart it to activate those changes:

$ /etc/init.d/exim4 restart

cPanel

If you are using cPanel with Exim and want to relay your email through Mailazy, go to Main > Service Configuration > Exim Configuration Editor, click on the Advanced Editor button, and enter the following in the AUTH Box:

begin authenticators

mailazy_login:
driver = plaintext
public_name = LOGIN
client_send = : mailazy_apikey : mailazy_secret

Only include "begin authenticators" if it's not already in the configuration.

Add a route in the Router Configuration Box:

send_via_mailazy:
driver = manualroute
domains =  ! +local_domains
transport = mailazy_smtp
route_list = "* smtp.mailazy.com::587 byname"
host_find_failed = defer
no_more

Add a transport to the Transport Configuration Box:

mailazy_smtp:
driver = smtp
hosts = smtp.mailazy.com
hosts_require_auth =  <; $host_address
hosts_require_tls =  <; $host_address