TrueNAS SCALETrueNAS SCALE Version Documentation
This content follows the TrueNAS SCALE 23.10 (Cobia) releases. Use the Product and Version selectors above to view content specific to different TrueNAS software or major version.

Email Screens

  3 minute read.

Last Modified 2024-03-19 08:38 EDT

The top toolbar Alerts notifications icon button and settings icon display the Alerts dropdown list with two options: Alert Settings and Email.

Select Email to go to the General settings screen and find the Email widget.

Email Widget

The Email widget on the General settings screen displays information about current system mail settings.

Email Widget
Figure 1: Email Widget

Settings opens the Email Options screen that allows users to configure the system email send method.

Email Options Screen

An automatic script sends a nightly email to the administrator account containing important information such as the health of the disks. Users must first configure an email address for the admin account or another administrative user in Credentials > Local Users.

The Email Options screen offers two options to set up email. Select either SMTP or GMail OAuth. The configuration settings change based on the selected radio button.

SMTP

If SMTP is selected, the screen displays the SMTP configuration fields.

SettingDescription
From EmailThe email address to use for sending emails. You must first configure the user account email in Credentials > Local Users.
From NameThe name to show in front of the sending email address, for example: TrueNAS.
Outgoing Mail ServerHost name or IP address of SMTP server to use for sending emails.
Mail Server PortSMTP port number. Typically 25, 465 (secure SMTP), or 587 (submission).
SecuritySelect the security option from the dropdown list. Options are Plain (No Encryption), SSL (Implicit TLS), or TLS (STARTTLS). See email encryption for more information on types.
SMTP AuthenticationSelect to enable SMTP AUTH using PLAIN SASL. Requires a valid user name and password.
UsernameDisplays when SMTP Authentication is selected. The user name for the sending email account, typically the full email address.
PasswordDisplays when SMTP Authentication is selected. The password for the sending email account.

Send Test Mail generates a test email to confirm the system email works correctly.

Save stores the email configuration and closes the Email Options screen.

Gmail OAuth

If GMail OAuth is selected, the screen displays Log in to Gmail to set up Oauth Credentials and the Log In To Gmail button.

After setting up Gmail OAuth authentication, the screen displays Gmail credentials have been applied and the button changes to Log In To Gmail Again.

Send Test Mail generates a test email to confirm the system email works correctly.

Save stores the email configuration and closes the Email Options screen.

Related Content

Related Alert Articles