On this page

Exim 4

(error)

Danger

Versions of Exim prior to the current major release are considered obsolete. If you are using Exim 3.x or earlier it is suggested by the Exim development team that you upgrade to the current release.

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:

1dc_eximconfig_configtype='smarthost'
2dc_other_hostnames=''
3dc_local_interfaces='127.0.0.1'
4dc_readhost='your.server.name'
5dc_relay_domains=''
6dc_minimaldns='false'
7dc_relay_nets=''
8dc_smarthost='smtp.sendgrid.net::587'
9CFILEMODE='644'
10dc_use_split_config='false'
11dc_hide_mailname='true'
12dc_mailname_in_oh='true'

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

(information)

Info

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

MAIN_TLS_ENABLE = 1

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

(information)

Info

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 SendGrid when you created the key).

*:apikey:<YourAPIKey>

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 SendGrid, go to Main > Service Configuration > Exim Configuration Editor, click on the Advanced Editor button, and enter the following in the AUTH Box:

1begin authenticators
2
3sendgrid_login:
4  driver = plaintext
5  public_name = LOGIN
6  client_send = : apikey : <YourAPIKey>

(information)

Info

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

Add a route in the Router Configuration Box:

1send_via_sendgrid:
2  driver = manualroute
3  domains = ! +local_domains
4  transport = sendgrid_smtp
5  route_list = "* smtp.sendgrid.net::587 byname"
6  host_find_failed = defer
7  no_more

Add a transport to the Transport Configuration Box:

1sendgrid_smtp:
2  driver = smtp
3  hosts = smtp.sendgrid.net
4  hosts_require_auth = <; $host_address
5  hosts_require_tls = <; $host_address

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

Exim Documentation

If your version of Exim does not match the version above or you are not finding the answer you need, please check out the Official Exim Documentation for more information.