README
¶
gopher-mail
Simple serverless personal mail system. Use AWS free tier or cheap services.
- SES
- S3
- SNS
- Lambda
- API Gateway
Moving parts:
- postmaster - handles sorting of all incoming mail
- mailman - reads mail and serves it to the web ui
- mailtruck - sends mail via SES
- web - vuejs spa for the user to interact with the systems above
TODO
- Move to terraform for infrastructure and lambda deployment
- Create simple front end to request mail for a mailbox
- Web skeleton
- Add multiple user auth
- Add sending of email
- Add rendering of html payloads
- Create mailman service to load and serve mail
- Create mailtruck service to send mail
- Feature creep postmaster
- Parse AWS-SES headers for virus checking and create sub-folders [spam, trash]
- Feature creep web
- Implement Auth
- Use markdown for email editor and MD to HTML for the html emails
Tech
Build
The build script will build each of the services into the bin folder.
./build.sh
Deploy
The deploy script will take the built binaries in the bin folder and create an archive for deployment to a lambda function.
Terraform is used to deploy and configure the services required to glue everything together. Create a terraform.tfvars from the example in the terrafrom folder and run the command below.
./deploy.sh
cd terraform/
terraform apply
Note: The terraform apply command will take around 10 minutes.
If you would like to use an S3 bucket for your terraform state, there is an example override in the terraform folder. You will need to create a private S3 bucket in your account and enter the bucket name into the override file.
Restrictions
Using SES to S3 email delivery caps email size at 30MB. At a later time this can be updated to use lambdas exclusively for a payload size only limited by the HTTP protocol and the lambda memory.
Price
Note: The following figures are preliminary and do not include data transfer rates.
The following table describes the price per month.
| Price | Service |
|---|---|
| $0.40 | AWS Secrets |
Total per year: $4.80
The following table describes worst case price per email, beyond the free tier.
| Price | Service | Free Tier Limit |
|---|---|---|
| ~ $0.00000001 | AWS Lambda | 1,000,000 |
| ~ $0.0001 | SES | 1,000 |
| ~ $0.000005 | S3 | 20,000 |
Web UI costs for viewing one email.
| Price | Service | Free Tier Limit |
|---|---|---|
| ~ $0.00000004 | AWS Lambda | 1,000,000 |
| ~ $0.000005 | S3 | 20,000 |
| ~ $0.00002 | Secrets Manger |
Directories