notifications.cfg

Description

The file /etc/proxmox-backup/notifications.cfg is a configuration file for Proxmox Backup Server. It contains the configuration for the notification system configuration.

File Format

This file contains configuration for notification targets and notification matchers.

Options

Section type 'filter': Config for the old filter system - can be removed at some point.

Section type 'gotify': Config for Gotify notification endpoints

Required properties:

server<string>

Gotify Server URL.

Optional properties:

comment<string>

Comment.

disable<boolean>

Disable this target.

filter<string>

Deprecated.

originuser-created|builtin|modified-builtin

The origin of a notification configuration entry.

Section type 'group': Config for the old target groups - can be removed at some point.

Section type 'matcher': Config for Sendmail notification endpoints

Optional properties:

comment<string>

Comment.

disable<boolean>

Disable this matcher.

invert-match<boolean>

Invert match of the whole filter.

match-calendar<string>

List of matched severity levels. Can be specified more than once.

match-field<string>

List of matched metadata fields. Can be specified more than once.

match-severity<string>

List of matched severity levels. Can be specified more than once.

modeall|any   (default=all)

The mode in which the results of matches are combined.

originuser-created|builtin|modified-builtin

The origin of a notification configuration entry.

target<string>

Targets to notify. Can be specified more than once.

Section type 'sendmail': Config for Sendmail notification endpoints

Optional properties:

author<string>

Author of the mail. Defaults to 'Proxmox Backup Server ($hostname)'

comment<string>

Comment.

disable<boolean>

Disable this target.

filter<string>

Deprecated.

from-address<string>

From address for sent E-Mails. If the parameter is not set, the plugin will fall back to the email-from setting from node.cfg (PBS). If that is also not set, the plugin will default to root@$hostname, where $hostname is the hostname of the node.

mailto<string>

Mail address to send a mail to. Can be specified more than once.

mailto-user<string>

Users to send a mail to. The email address of the user will be looked up in users.cfg. Can be specified more than once.

originuser-created|builtin|modified-builtin

The origin of a notification configuration entry.

Section type 'smtp': Config for Sendmail notification endpoints

Required properties:

from-address<string>

From address for the mail. SMTP relays might require that this address is owned by the user in order to avoid spoofing. The From header in the email will be set to $author <$from-address>.

server<string>

Host name or IP of the SMTP relay.

Optional properties:

author<string>

Author of the mail. Defaults to 'Proxmox Backup Server ($hostname)'

comment<string>

Comment.

disable<boolean>

Disable this target.

mailto<string>

Mail address to send a mail to. Can be specified more than once.

mailto-user<string>

Users to send a mail to. The email address of the user will be looked up in users.cfg. Can be specified more than once.

modeinsecure|starttls|tls   (default=tls)

Connection security

originuser-created|builtin|modified-builtin

The origin of a notification configuration entry.

port<integer> (0 - 65535)

The port to connect to. If not set, the used port defaults to 25 (insecure), 465 (tls) or 587 (starttls), depending on the value of mode

username<string>

Username to use during authentication. If no username is set, no authentication will be performed. The PLAIN and LOGIN authentication methods are supported