How to enable sendEmail with TLS with NoMa
Click the link above if you are not automatically redirected in 10 seconds.
GroundWork Monitor allows you to send email notifications with modern email services such as Gmail or Office 365, as a TLS compliant client. These instructions will walk you through the steps of setting up this client with the NoMa notification manager.
What you'll need:
- A service user email account to authenticate and send email on the service (e.g., Gmail account)
- An app password for the user account
- An app password is a password that is separate from the normal email client password. You usually have to generate these from your email service account settings, e.g., App Password for Google and App Password for Office 365.
- Outbound network access on port 587 or similar port (usually open if you use one of these hosted email services)
Configuring TLS compliant client with NoMa
Log in to the command line on your GroundWork 8 server, and go to the
gw8
directory.Edit the
gw8.env
file and add the following lines:SMTPSERVER_SERVERPORT=smtp.mymail.com:587 SMTPSERVER_TLS=yes SMTPSERVER_AUTHUSER=myserviceaccount@mymail.com SMTPSERVER_AUTHPASS=myapppassword
where
smtp.mymail.com:587
is your email service endpoint and port,myserviceaccount@mymail.com
is the service user email account, andmyapppassword
is the app password.Restart the NoMa daemon after making this change to have the system pick up the new configuration:
docker-compose kill noma_daemon docker-compose up -d noma_daemon
To test, enter the following from the command line:
docker-compose exec noma_daemon /usr/bin/sendEmail -f myserviceaccount@mymail.com -t myemailaddress@mydomain.com -u 'test from noma' -m '***** NoMa *****' -u 'test from noma'
where
myserviceaccount@mymail.com
is the service account, andmyemailaddress@mydomain.com
is an email account you have access to. You should see the test email arrive within a few minutes. If you have something other than a message on the screen with email sent successfully, please correct the issue before proceeding.Restart the NoMa daemon:
docker-compose kill noma_daemon docker-compose up -d noma_daemon
At this point, you should be able to configure contacts in the NoMa notification screens, and see email coming through when notifications are triggered.
Related articles
-
How to use Nagios to send notifications to NoMa (Knowledge Base)
-
How to use includes excludes in NoMa (Knowledge Base)
-
How to configure notifications using NoMa (Knowledge Base)
-
How to schedule downtime (Knowledge Base)
-
Nagios Notifications (GroundWork Support 8)
-
Home Dashboard (GroundWork Support 8)
-
GroundWork Messenger (GroundWork Support 8)