Configuring system email notifications

Email notifications provide alerts for events like password recovery, license status, product updates, and resource-specific notifications such as job or robot alerts. They can be configured at two levels: host and organization. The host-level applies settings across all organizations in the platform, but they can be overriden at the organization level.

To configure email preferences, log in to the host Management portal as a system administrator and navigate to the Global Settings page.

Email setup

Field	Description
SMTP Host	The IP or Domain of the SMTP server.
SMTP Domain	Domain for the username, if SMTP server requires authentication.
SMTP Port	The SMTP port. For example, if you are using a Gmail account to send mail messages and Enable secure connection is selected, the port should be 587. Note that both ports 80 and 587 must be opened during installation for Enable secure connection to work.
SMTP Username	The username of the SMTP server, if it requires authentication. For example, if you are using Gmail, fill in this field with the email address to be used to send messages. You can leave this field blank if you want to use anonymous authentication.
SMTP Password	The password for the email account specified in SMTP Username. You can leave this field blank if you want to use anonymous authentication.
Default From Address	The email address from which to send system email messages.
Default From Display Name	A custom display name for the email address from which you send system notifications.

System emails are not sent - SslHandshakeException

For offline installations, if system emails are not sent and you encounter the error SslHandshakeException, make sure that both port 80 and port 587 are opened for the machine.

Email preference

Option	Description
Enable secure connection	If enabled, the connection is secured and a TLS certificate is required for the SMTP domain you are using. If disabled, the connection is not secured. Note: Both port 587 and port 80 must be opened during installation for this setting to work.

Example: Configuring the SMTP Server for a Google Account

Configuring the SMTP Server for a Google account is not very different from any regular configuration. In the host management portal, configure the settings as follows:

• SMTP Host: smtp.gmail.com (Google SMTP server).
• SMTP Port: 587 (default Google SMTP port).
• SMTP Username: The email address to send mail messages from. For example, [e-mail].
• SMTP Password: The password for the email address you want to use. It has to be the password of the account that was specified in the SMTP Username field.
• Default From Address: The email address from which to send the email messages. It has to be the same one as the one used in the SMTP Username field, in our example, [e-mail].
• Default From Display Name: A custom name you want recipients to see for the sender of the email notification. For example, Orchestrator System Notifications.

If you provide a Google account for the SMTP Username, you also need to do the following:

1. Open a web browser and log in to Google with the credentials used in the SMTP Username and SMTP Password fields.
2. Allow Orchestrator to access the account by clicking this link .
3. If the account does not have 2-step verification, then you must allow less secure apps by following this link and turning the Allow less secure apps option to ON.

   This ensures that the password reset request is properly processed and delivered from the email address configured in the Mail tab to the one configured in the Users page of the user making the request.