Sets the maximum number of deleted or missing files allowed before a -sync operation is automatically aborted. This serves as a safety -mechanism to prevent accidental parity loss due to unintended mass -deletions. This safety check is enforced during automated maintenance -schedules and tasks initiated through the Web UI. +
Sets the number of deleted or missing files that will trigger an automatic +abort of a sync operation. The abort occurs when the number of deletions +is equal to or greater than this value. This serves as a safety mechanism +to prevent accidental parity loss; for example, setting this to 1 will +abort the operation if any single file is deleted. This check is +enforced during automated maintenance schedules and tasks initiated +through the Web UI.
Sets the maximum number of modified or updated files allowed before a -sync operation is aborted. Similar to the delete threshold, this -prevents the parity from being overwritten if an unexpected number -of files have changed. This safety check is enforced during automated -maintenance schedules and tasks initiated through the Web UI. +
Sets the number of modified or updated files that will trigger an +automatic abort of a sync operation. The abort occurs when the number +of updates is equal to or greater than this value. This prevents the +parity from being overwritten if an unexpected number of files have +changed. Similar to the delete threshold, setting this to 1 will abort +the operation if any single file is modified. This check is enforced +during automated maintenance schedules and tasks initiated through +the Web UI.
Specifies the user account used to execute the hook_script. If this is missing or blank, the script is executed with the same privileges as the daemon process. -
On Linux, nobody is the standard choice for maximum isolation. -On Windows, LocalService is the preferred choice as it provides +
On Linux, nobody is the standard choice for maximum isolation. Note that +using nobody may prevent certain tools, such as Docker, from functioning +correctly due to restricted permissions. Ensure you are aware of these +limitations before applying this setting. +
On Windows, LocalService is the preferred choice as it provides minimal local access while maintaining network capabilities. Alternatively, NetworkService can be used if the script specifically requires the computer's network identity to access remote resources. @@ -940,7 +948,35 @@ high-level tasks or by a SMART telemetry change. The command is only executed if the task's result matches the notify_result_level. The daemon pipes a structured, plain-text task report directly into the command's stdin. -
The daemon automatically chooses a wide (80-col) or narrow (32-col) +
Examples of usage: +
+The daemon automatically chooses a wide (80-col) or narrow (32-col) report based on the command and arguments used (e.g., presence of mail or smtps strings). Users can manually override this by adding --wide or --narrow to the command string. These tags are stripped before execution. @@ -984,17 +1020,36 @@ compatibility with curl's SMTP engine.
When using curl for SMTP, it is recommended to use the --netrc flag. This allows curl to read credentials from a local file rather than exposing passwords in the command line or process list. -
File format (~/.netrc): +
+File format (.netrc or _netrc):
machine smtp.gmail.com login your_email@gmail.com -password your-16-char-app-password +password your-16-char-app-password-without-spaces-
If notify_run_as_user is configured, ensure that user has a valid -home directory containing a .netrc file with 600 permissions for SMTP -authentication. Failure to do so may result in authentication errors -(e.g., curl error 55). -
The user account used for notify_heartbeat, notify_result and mail notifications. If missing or left blank, the task runs with the daemon's current privileges. -
On Linux, nobody is the standard choice for maximum isolation. -On Windows, LocalService is the preferred choice as it provides +
On Linux, nobody is the standard choice for maximum isolation. However, +while sufficient for simple curl commands, it may cause failures for +mailers (like sendmail or postfix) that require specific group memberships +or access to mail queues. Verify that your notification tools can operate +without a home directory or write access to system logs. +
On Windows, LocalService is the preferred choice as it provides minimal local access while maintaining network capabilities. Alternatively, NetworkService can be used if the script specifically requires the computer's network identity to access remote resources.