The e-mail notification system

Setup

To be able to send e-mails from FileRun, you need to either have PHP configured with sendmail or have FileRun configured with an SMTP server.

You can change the e-mail settings from the FileRun control panel under E-mail → SMTP.

Do note that most SMTP servers require authentication, and to prevent spam and other attacks, some don't even allow you to send e-mails from other addresses than the one configured for authentication. So don't be surprised if you are trying to send a file from a particular e-mail address and the recipient sees the message as coming from the address you used for the SMTP authentication.

FileRun tries to detect your SMTP server configuration and in some cases will use STARTTLS even if you don't want to. If that is the case, the solution is to add configure FileRun with:

 1$config['system']['email']['smtp_options'] = [
 2  'SMTPAutoTLS' => false
 3];

Not recommended, but if you need to disable the SSL certificate checking, you can do so:

 1$config['system']['email']['smtp_options'] = [ 
 2  'ssl' => [
 3    'verify_peer' => false, 
 4    'verify_peer_name' => false,
 5    'allow_self_signed' => true
 6  ]
 7];

By default, the e-mail notification messages are sent from the e-mail address "some@email-address.com". Change this to a valid e-mail address under the E-mail contro panel section.

Introduction

There are three ways you can configure FileRun to send e-mail notifications:

The Notifications checkbox

The admin can enable or disable the Notifications checkbox when adding or editing a user account. In this case, the user will receive e-mail notification messages when:

The above can be customized, by either removing or adding triggers. Please see $config['app']['email_notification']['basic_actions'] on the advanced configuration page.

The users themselves can also enable or disable these notifications from their Account settings panel.

One requirement for e-mail notifications to be sent on other users' actions is the permission to Can interact with. This is set from the control panel, under the Permissions tab, when editing a user account. If user A isn't aware of the existence of user B, user A will not be notified if user B makes changes inside user A's folders.

This option applies only to actions performed inside the user's configured home folder. It does not apply to files and folders accessed via other user's shares.

The Control Panel → Notifications section

Admin users can also use the Control Panel → Notifications section for setting up rules for notifications. Here you manually select which user-performed actions should send e-mail notifications. Using this option you can configure e-mail notifications to be sent to different e-mail addresses than the ones set for the user accounts.

Per folder notifications

Users can choose to be notified when certain actions are being performed in a particular folder, by right-clicking the folder and selecting the Notifications option. The users can choose to be notified about various actions performed by other users on files located inside the selected folder.