This article is only applicable to on-premise installations. If you are a SaaS customer, email settings are automatically configured.
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.
| 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. 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.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. 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. 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. 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. Value options: SMTP password Requires restart? No |
Depends on email provider |
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 |