AWS SES Email Relay

Receive email from AWS SES then relay it to your desired destination.

WARNING: Currently this does not work with attachments.

Install

git clone https://github.com/kdcio/aws-ses-email-relay.git
cd aws-ses-email-relay
npm i
npm i serverless -g

USAGE

Create config file

Create a config.{name}.yml in the project root. Replace {name} with your deployment name. eg. prod

config.prod.yml:

REGION: us-east-1
PROFILE: my-aws-profile
DESTINATION:
  "my.yahoo@receiving-email.com": my.admin@yahoo.com
  "my.gmail@receiving-email.com": my.admin@gmail.com
  "default":
    - my.admin@gmail.com
    - my.admin@yahoo.com
FROM: my@receiving-email.com

DESTINATION is a mapping of recepient email to destination email. The destination email can be an array. default is a catch all destination.

FROM should be a fallback email address capable of sending emails via your AWS account.

Deploy to AWS

Based on config above:

npm run deploy prod

Set SES Rule Sets

Navigate to your SES Rule Sets in AWS Console. In you rule, select SNS. Then SNS topic as aws-ses-email-relay-prod. Hit Save Rule and you should ready to go.

Uninstall

npm run remove prod
cd ..
rm -fR aws-ses-email-relay