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 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

Default
behavior

Value optionsDescriptionConfiguration required for email functionalityRequires restart?

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.

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.Depends on email providerNo

email.mailto.rcpt_to



Contact forms in NetX and Portals send email to this address.No, but the NetX Contact form will not appear in the UI until this property is configured.No
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.

SaaS customers: do not modify this property.

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.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.Depends on email provider
email.sendThreshold100
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'.No
email.userNotifyBlocksAllEmailtruetrue, falseThis 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.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

Default
behavior

Value optionsDescriptionConfiguration required for email functionalityRequires restart?
email.logger.enabledtruetrue, falseBy 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".NoYes
email.smtp_debugfalsetrue, falseWhen this property is enabled, the entire transcript of the SMTP traffic between NetX and the mail server will be sent to email.log.NoNo