https://github.com/kdcio/aws-ses-email-relay
Relay emails from AWS SES
https://github.com/kdcio/aws-ses-email-relay
aws aws-ses relay-emails ses
Last synced: about 2 months ago
JSON representation
Relay emails from AWS SES
- Host: GitHub
- URL: https://github.com/kdcio/aws-ses-email-relay
- Owner: kdcio
- License: mit
- Created: 2020-05-10T04:31:22.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2026-01-26T10:50:03.000Z (5 months ago)
- Last Synced: 2026-01-27T00:36:44.383Z (5 months ago)
- Topics: aws, aws-ses, relay-emails, ses
- Language: JavaScript
- Homepage:
- Size: 736 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 47
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# 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
```bash
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:
```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:
```bash
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
```bash
npm run remove prod
cd ..
rm -fR aws-ses-email-relay
```