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. On-premise customers can reference those configuration properties below. 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_host

Sets the SMTP hostname or IP address that NetX will use to send all email. Without this property, no email can be sent from the system.

Note for SaaS customers: do not modify this property.

Value options: SMTP hostname / IP address, e.g. mail.company.com

Requires restart? No

Yes
email.smtp_port

The port that the server specified in email.smtp_host uses for SMTP communication.

Note for SaaS customers: do not modify this property.

Value options: SMTP port, e.g. 25

Default value: 25

Requires restart? No

Yes
email.smtp_username

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

Note for SaaS customers: do not modify this property.

Value options: SMTP username

Requires restart? No

Depends on email provider
email.smtp_password

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

Note for SaaS customers: do not modify this property.

Value options: SMTP password

Requires restart? No

Depends on email provider
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

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