https://github.com/fredlackey/smtp-receiver
Receives incoming SMTP email messages and writes them out to a file.
https://github.com/fredlackey/smtp-receiver
smtp
Last synced: 2 months ago
JSON representation
Receives incoming SMTP email messages and writes them out to a file.
- Host: GitHub
- URL: https://github.com/fredlackey/smtp-receiver
- Owner: FredLackey
- License: apache-2.0
- Created: 2020-05-13T18:11:10.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2022-07-07T19:47:35.000Z (almost 3 years ago)
- Last Synced: 2025-01-24T10:30:33.752Z (4 months ago)
- Topics: smtp
- Language: JavaScript
- Homepage: http://fredlackey.com
- Size: 479 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SMTP Receiver
Receives incoming SMTP email messages and writes them out to a file.
## Background
As I move my domains to AWS, those domains on "stand-by" need to account for emails mistakingly being sent to them. Since they are not yet profitable, I do not want to incur the cost -- financially or otherwise -- of standing up a mail server. So, whipping up a quick SMTP receiver service seemed like the easy answer.
## Installation
This project is being made public in case it helps someone else. However, I've only built enough for it to suit my needs thus far. It builds upon the project from [Nodemailer](https://nodemailer.com) and adds common intelligence for whitelisting or blacklisting hosted domains and addresses. That being said, there is not an actual installer. However, if you do want to use it for receiving emails, you _could_ do as follows:
```
git clone [email protected]:FredLackey/smtp-receiver.git
cd ./smtp-receiver
npm i
./start-dev.sh
```
## Configuration
The provided startup scripts are what I generally use in development. This is where I set environment vaiables and launch the appropriate process (nodemon in dev, node in prod). Should you want to use them, you would need to tweak the settings to match your environment:
```
#! /bin/bash
export DATA_DIR="$PWD/.env.test"
export NODE_ENV="development"
export SMTP_PORT="3000"
npm run dev
```
### Required Node Tweaks
By default, nNix systems (macOS included) does not allow binding to ports lower than 1024. You either need to run as `sudo` or allow Node to bind to these lower ports. Should you want to take the latter approach, first, find the location of your Node binary...
```
$ which node
/home/ubuntu/.nvm/versions/node/v12.16.3/bin/node
```
Once you have this path, you use the `setcap` utility to give Node access...
```
sudo setcap 'cap_net_bind_service=+ep' /home/ubuntu/.nvm/versions/node/v12.16.3/bin/node
```
## Contact Info
Feel free to reach out if you need a hand:
**Fred Lackey**
[fredlackey.com](http://fredlackey.com)
[[email protected]](mailto://[email protected])