Overview
Configuring the SMTP server determines the mail server and account that will be used to generate the global email notifications. Once you add the information, you can test the connection to ensure no additional settings need to be added for the notifications to work. DryvIQ uses MailKit, which includes a default server certificate validation for a list of commonly used mail servers such as gmail.com, outlook.com, mail.me.com, yahoo.com, and gmx.net.
Notifications cannot be set up on an SMTP server that has an untrusted SSL certificate. The environment where DryvIQ is running needs to trust the certificate. This can be done by manually trusting the certificate or using a valid self-signed certificate.
Configuring the Server
Select Settings > Notifications.
You will see a red circle and text that reads, “SMTP server is disabled.” This indicates an SMTP server has not been set up. If the circle is green followed by text that reads, “SMTP Server is enabled,” an SMTP configuration exists, and you do not need to proceed unless you need to edit the SMTP server settings.
Select Configure SMTP server.
The Add SMTP server modal opens.
Enter the Server name. This is the fully qualified domain name of the SMTP service. This is required field.
In Server port, enter the SMTP service port number. This is usually 587. Port 25 or 465 can be used, but these are not recommended ports.
The From field allows you to set an address to be used as the “from” information when the email message is generated. If you do not specify this information, the username will be used. This is a required field if a username is not provided.
In Username, specify the SMTP username. In some instances, this will be your email address, but this could vary based on the service you use. This is a required field if your SMTP server requires authentication.
Use the Password field to specify the SMTP service password. In some instances, this will be the email password for username specified, but this could vary based on the service you use. This is a required field if your SMTP server requires authentication.
Select Test connection to test the connection to the server.
If the test is successful, you will see a green message that reads, “SMTP server configuration test succeeded.”
If the connection fails, you will see a red message that reads, “SMTP server configuration test failed.” Edit the information, and perform another test.
Select Done to close the modal.
You will now see a green circle followed by text that reads, “SMTP Server is enabled.”
For more information about SMTP ports, refer to this blog post by SocketLabs.