Configuring an SMTP Server
Learn how to configure an SMTP server to use for notifications.
Table of Contents
Overview
Configuring the SMTP server determines the mail server and account that will generate the global email notifications. Once you add the information, you can test the connection to ensure no additional settings are needed. 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 with 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
- Click Settings in the left menu.
- Click 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 and 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.
- Click 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 a 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.
- The Socket options list allows you to specify the encryption to use. TLS encryption is used by default. Choose a different option from the list if preferred.
- 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. This may be your email address, but it could vary depending on your service. This field is required 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 the username specified, but this could vary based on the service you use. This is a required field if your SMTP server requires authentication.
- Click 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.
- Click 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 information provided by SocketLabs.