Get a Quote   (408) 943-4100               TrueNAS Discord      VendOp_Icon_15x15px   Commercial Support Toggle between Light and Dark mode

System Email

  2 minute read.

Last Modified 2022-04-26 14:02 EDT

An automatic script sends a nightly email to the administrator (root) account containing important information such as the health of the disks. Alert events are also emailed to the root user account. Configure the system to send these emails to the administrator’s remote email account for fast awareness and resolution of any critical issues.

Scrub Task issues and S.M.A.R.T. reports are mailed separately to the address configured in those services.

TrueNAS Root Email Address

Before configuring anything else, set the root account email address. Go to Credentials > Local Users, click and Edit for the root user. In the Email field, enter a remote email address that the system administrator regularly monitors (like admin@example.com) and click Save.

Email Options

For the next step, you must go to the System Email screen.

Click the Alerts icon in the top right of the UI, then click the gear icon and select Email.

Changing the Send Mail Method shows different options:

AlertEmailSMTP

NameDescription
From EmailThe user account email address to use for the envelope from email address. You must configure the user account email first in Accounts > Users > Edit.
From NameThe friendly name to show in front of the sending email address. Example: Storage System 01it@example.com
Outgoing Mail ServerHostname or IP address of SMTP server used for sending email.
Mail Server PortSMTP port number. Typically 25/465 (secure SMTP), or 587 (submission).
SecurityChoose an encryption type. Choices are Plain (No Encryption), SSL (Implicit TLS), or TLS (STARTTLS).
SMTP AuthenticationSet when the SMTP server uses authentication credentials. Shows additional credentials options.

To use Gmail OAuth, select the option and click Log In To GMail.

AlertEmailGMail

Log into a GMail account as normal for TrueNAS to autoconfigure the connection to GMail.

Click Send Test Mail to verify the configured email settings are working. If the test email fails, verify that the root user Email field is correctly configured by clicking the Edit button for the root account in Credentials > Local Users.