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 |