Skip to content

Latest commit

 

History

History
70 lines (50 loc) · 2.67 KB

README.md

File metadata and controls

70 lines (50 loc) · 2.67 KB

SMTP Proxy for Notify

This is a simple SMTP proxy for Notify that bridges the gap between the SMTP protocol and the Notify API. The proxy listens for SMTP connections and converts the SMTP message into a Notify API call. The Notify API then sends the message to the recipient. Attachments are supported.

Usage

Requirements

  • A Notify account
  • A Notify API key
  • A Notify template ID

Your template must have a subject and body field. For example, the template should look something like this:

An image showing a Notify template

Environment variables

Variable Description Required Default
NOTIFY_APIKEY Your Notify API key Yes
NOTIFY_HOSTNAME The hostname of the Notify API No https://api.notification.canada.ca
NOTIFY_TEMPLATE_ID Your Notify template ID Yes
SMTP_TLS_CERT_FILE Path to your TLS certificate file No
SMTP_TLS_KEY_FILE Path to your TLS key file No
SMTP_USE_TLS Whether to use TLS or not No false
SMTP_HOSTNAME The hostname to listen on No localhost
SMTP_PORT The port to listen on No 1025
SMTP_USERNAME The username to use for authentication Yes
SMTP_PASSWORD The password to use for authentication Yes

Running

Locally

You can run the proxy locally using the following command as long as you have all the environment variables set:

./release/latest/smtp-proxy-for-notify

Docker

The proxy can also be run using Docker. You can build the image using the Dockerfile in this repository. However, you should provide your own TLS certificate and key files. You can do this by building the image with the SMTP_TLS_CERT_FILE and SMTP_TLS_KEY_FILE build arguments. For example:

docker build --build-arg SMTP_TLS_CERT_FILE="example_certs/server.crt" --build-arg=SMTP_TLS_KEY_FILE="example_certs/server.key" -t smtp .

The alternative is to mount the certificate and key files into the container at runtime.

To run the container, you can use the following command assuming you built it with the Dockerfile in this repository:

docker run \
    -e NOTIFY_APIKEY=gcntfy-test-00000000-0000-4000-8000-000000000000-00000000-0000-4000-8000-0000000000000 \
    -e NOTIFY_TEMPLATE_ID=00000000-0000-4000-8000-0000000000008 \
    -e SMTP_TLS_CERT_FILE=/etc/ssl/certs/server.crt \
    -e SMTP_TLS_KEY_FILE=/etc/ssl/private/server.key \
    -e SMTP_USE_TLS=true \
    -e SMTP_HOSTNAME=0.0.0.0 \
    -e SMTP_USERNAME=username \
    -e SMTP_PASSWORD=longpasswordgo \
    -p 1025:1025 \
    smtp

License

MIT License