NetX Global Email Settings

NetX can be configured to send various types of email. For example:

  • System-generated: Notifications that are triggered by various events such as file uploads, downloads, errors, and custom AutoTasks.
  • User-generated: Emails that are launched from manual workflows such as sharing files, collections, requesting approval, etc.

To properly send email, NetX must be configured with a valid SMTP server that uses port 25 for communication. SSL is not currently supported. Listed below are the configuration properties. For more information on how to create or edit properties, see Configuring Properties.

If you are a SaaS customer and wish to authorize NetX's SMTP servers to send mail from email addresses in your domain, please see this article: Setting up an SPF Record.

Property Description Configuration required for email functionality
email.from

This email address is used as the From address for system-generated emails, such as import reports. When this property is configured, all user-generated emails such as collection sharing, etc will originate from the email address associated with the user's account.

Value options: email address

Requires restart? No

Depends on email provider
system.email.globalFromAddress

If you want to send all email in the application from a specific email address (to avoid SMTP server issues with heterogeneous domains) you can now set the "system.email.globalFromAddress" property to a valid email address. When this property is enabled, the SMTP "From" will be universally set to the property value. For SaaS customers, this is set to donotreply@netx.net by default. The email.from property must be set to the same email address value for this property to work.

Value options: email address

Requires restart? No

Depends on email provider
email.mailto.rcpt_to

Contact forms in NetX and Portals send email to this address.

Value options: email address

Requires restart? No

No, but the NetX Contact form will not appear in the UI until this property is configured.
email.smtp

The email.smtp sets the SMTP hostname that NetX will use to send all email. Without this property, no email can be sent from the system. Eg: mail.yourdomain.com.

Note for SaaS customers: do not modify this property.

Value options: SMTP hostname

Requires restart? Yes

Yes. Requires an SMTP server that uses port 25 for SMTP communication. SSL is not currently supported.
email.smtp_username

This property — used in conjunction with email.smtp_password — allows for the authentication with the SMTP service specified with the email.smtp property.

Value options: SMTP username

Requires restart? Yes

Depends on email provider
email.smtp_password

This property — used in conjunction with email.smtp_username — allows for the authentication with the SMTP service specified with the email.smtp property.

Value options: SMTP password

Requires restart? Yes

Depends on email provider
email.sendThreshold

The email.sendThreshold sets the maximum number of email messages that can be sent to a single email address within a one hour period. The default is 100.

Value options: number

Requires restart? Yes

No
email.userNotifyBlocksAllEmail

This property allows users to block all email sent to themselves from the system. Setting this property to "true", then allows users to set the "notify" value to "off" in their user profile. With both of these values set (system property and user preferences attribute), then that user will no longer receive emails from the system.

Value options: number

Requires restart? Yes

No

 

Email logging

NetX's email.log can be helpful when trying to troubleshoot email issues. The properties below can be used to disable/enable certain levels of email logging.

Property Description Configuration required for email functionality
email.logger.enabled

By default, sent emails and failed attempts will be logged to an "email.log" file (in the designated logs directory). If you want to turn this logging off, you can do so by setting this property value to false.

Value options: true / false

Requires restart? Yes

No
 
Was this article helpful?
0 out of 0 found this helpful