##### Open Source RWSERVE plugin

Nodemailer

Send mail using server-side JavaScript

by Read Write Tools Oct 24, 1028

$3

There are many applications where sending an email in response to an HTTP POST
is required. This module is a proof-of-concept plugin that demonstrates one way
to send SMTP messages using the Nodemailer module.

#### Customization

This plugin is open-source and may be extended to provide additional features,
such as:

* Accepting additional form elements such as user profile data or answers to
survey questions.
* Customizing the outgoing emails with different messages based on form inputs.
* Storing email addresses using a file or database.
* Sending HTML instead of plain text.

$3

The plugin module is available from NPM
. Before proceeding, you should already have Node.js and RWSERVE configured and
tested.

This module should be installed on your web server in a well-defined place, so
that it can be discovered by RWSERVE. The standard place for public domain
plugins is /srv/rwserve-plugins.

cd /srv/rwserve-plugins
npm install rwserve-nodemailer

$3

Make the software available by declaring it in the plugins section of your
configuration file. For detailed instructions on how to do this, refer to the plugins
documentation on the Read Write Tools HTTP/2 Server website.

#### TL;DR

plugins {
    rwserve-nodemailer {
        location /srv/rwserve-plugins/node_modules/rwserve-nodemailer/dist/index.js
        config {
            transport {
                host              127.0.0.1
                port              25
                authMethod        PLAIN
                connectionTimeout 2000
            }
            message-defaults {
                from     welcome.team@example.com
                subject  Welcome
                text     Thank you for signing up today.%0D%0AThis message confirms your request to join our mailing list.%0D%0ATogether we can make it happen!
            }
        }
    }
    router {
        customer-service/signup  methods=POST  plugin=rwserve-nodemailer
    }    
}

$3

The plugin receives POST requests originating from a standard HTML

#### CURL Test

You can also use CURL to send a request to the plugin like this:

curl https://localhost:7443/customer-service/signup -X POST -H content-type:application/x-www-form-urlencoded -H content-length:33 -d "recipient=friendly@mailinator.com"

#### Cookbook

A full configuration file with typical settings for a server running on
localhost port 7443, is included in this NPM module at etc/nodemailer-config. To
use this configuration file, adjust these variables if they don't match your
server setup:

$PLUGIN-PATH='/srv/rwserve-plugins/node_modules/rwserve-nodemailer/dist/index.js'
$PRIVATE-KEY='/etc/pki/tls/private/localhost.key'
$CERTIFICATE='/etc/pki/tls/certs/localhost.crt'
$DOCUMENTS-PATH='/srv/rwserve/configuration-docs'
$RECIPIENT='welcome.team@example.com'

#### Deployment

Once you've tested the plugin and are ready to go live, adjust your production
web server's configuration in /etc/rwserve/rwserve.conf and restart it using systemd
. . .

[user@host ~]# systemctl restart rwserve

. . . then monitor its request/response activity with journald`.

[user@host ~]# journalctl -u rwserve -ef

$3

This is a plugin for the Read Write Tools HTTP/2 Server, which works on Linux
platforms.

$3

$3

The rwserve-nodemailer plugin is licensed under the
MIT License.

$3