Home
Submit fixes on github
Follow me on twitter


Amazon SES setup

Sandbox note

New accounts are in the SES sandbox.
Go to SES account dashboard to see if I’m still in the sandbox.

First time setup

AWS console setup

Be careful to start in the correct region (Ohio for aiproxy.pro):
https://us-east-2.console.aws.amazon.com/ses/home?region=us-east-2#/account

In the left sidebar go to Configuration > Configuration sets, then:

In the left sidebar go to Configuration > Identities, then:

In the left sidebar, go to SMTP settings > Create SMTP credentials, then:

On my AL2023 box

Ensure sendmail is installed:

yum install sendmail sendmail-cf mailx -y  

Edit /etc/mail/authinfo to contain:

AuthInfo:email-smtp.us-east-2.amazonaws.com "U:root" "I:<smpt-user>" "P:<smtp-pass>" "M:PLAIN"  

Edit /etc/mail/access to contain:

Connect:email-smtp.us-east-2.amazonaws.com RELAY  

Edit /etc/mail/sendmail.mc to contain (change aiproxy.pro):

define(`SMART_HOST', `email-smtp.us-east-2.amazonaws.com')dnl  
define(`RELAY_MAILER_ARGS', `TCP $h 587')dnl  
define(`confAUTH_MECHANISMS', `LOGIN PLAIN')dnl  
FEATURE(`authinfo', `hash -o /etc/mail/authinfo.db')dnl  
MASQUERADE_AS(`aiproxy.pro')dnl  
FEATURE(masquerade_envelope)dnl  
FEATURE(masquerade_entire_domain)dnl  
MAILER(smtp)dnl  
MAILER(procmail)dnl  

Ensure sendmail is running:

systemctl start sendmail  
systemctl status sendmail  

Send a test mail

echo "body" | mailx -s "subject" -S from="aiproxy support <support@aiproxy.pro>" my-verified-email@domain.tld  

How to debug sendmail

If emails aren’t arriving, check the sendmail logs with:

systemctl status sendmail --full --no-pager | view -  
:set nowrap  

Or tail the logs with:

journalctl -fu sendmail  

If the log is:

reply=554 Message rejected: Email address is not verified. The following identities failed the check in region US-EAST-2  

it’s because the SES account is still in sandbox and I’m trying to send an email to an unverified email.
Using domain-based verification is not enough to send sandbox emails, even if they are going to that domain.
This is a bug in AWS; their docs state that this should be possible:

| You can only send mail to verified email addresses and domains  

To fix, go to ‘Left sidebar > Get set up > Verify email address > Create identity’ and submit an email address.
Tap through the email verification link and then try sending a test mail again.

echo "body" | mailx -s "subject" -S from="aiproxy support <support@aiproxy.pro>" my-verified-email@domain.tld  

Other ways to test email sending:

Send a test email using sendmail:

echo "Subject: test" | /usr/sbin/sendmail -vf lou@aiproxy.pro my-verified-email@domain.tld  
                                              ^from           ^to  

Send a test email using aws-cli:

aws ses send-email --from support@aiproxy.pro --destination "ToAddresses=my-verified-email@domain.tld" --message "Subject={Data=Test Email,Charset=utf8},Body={Text={Data=This is a test email sent from Amazon SES.,Charset=utf8}}"  

Send a test email using SMTP interface:

Base64 the SMTP user name and SMTP pass:

$ irb  
> def base64_encode(str)  
>   [str].pack('m').gsub(/\s+/, '')  
> end  

base64_encode(<smtp_user>)  
base64_encode(<smtp_pass>)  

Use the results in the following template:

echo "EHLO aiproxy.pro  
AUTH LOGIN  
my_base64_encoded_smtp_user  
my_base64_encoded_smtp_pass  
MAIL FROM: support@aiproxy.pro  
RCPT TO: my-verified-email@domain.tld  
DATA  
X-SES-CONFIGURATION-SET: aiproxy  
From: "aiproxy support" <support@aiproxy.pro>  
To: my-verified-email@domain.tld  
Subject: Hello  
World  
.  
QUIT  
" > /etc/mail/email.txt  

Send the email:

openssl s_client -crlf -quiet -starttls smtp -connect email-smtp.us-east-2.amazonaws.com:587 < /etc/mail/email.txt