1. Manuals
  2. Tumbleweed
  3. systemd-status-mail
  4. systemd-status-mail(8)

Scroll to navigation

systemd-status-mail(8) systemd-status-mail(8)

NAME

systemd-status-mail - Send a mail if a systemd.timer fails

SYNOPSIS

/usr/libexec/systemd-status-mail

/usr/lib/systemd/system/systemd-status-mail@.service

DESCRIPTION

systemd-mail-status is called by systemd-status-mail@.service if the service is configured for the OnFailure and/or OnSuccess case of a systemd unit. It sends an email to a configureable address with the name of the service, the hostname and the output of systemctl status --full <service>.

CONFIGURATION OPTIONS

Address to which the status mail should be send.
Sender address of the status mail.
Name of the host used as domain for the from address (root@$HOSTNAME)
Name of the mail client to send the status mail. Valid values are “sendmail” and “mailx”, by default “sendmail” is used.
Mail relay used by mailx(1) if specified and not empty.
Additional options passed to mailx(1)

CONFIGURATION FILES

/usr/etc/default/systemd-status-mail
Vendor provided configuration file, contains the defaults.
/etc/default/systemd-status-mail
Admin provided configuration file, should only contain the variables which were changed by the system administrator compared to the vendor configuration file.

Example

To get informed if os-update(8) failed, create a file status-mail.conf in the /etc/systemd/system/os-update.service.d/ directory with the content:

[Unit]
OnFailure=systemd-status-mail@%n.service

Everytime the os-update.service fails, a mail is send.

SEE ALSO

os-update(8), mailx(1), sendmail(1), postfix(1)

AUTHORS

Thorsten Kukuk <kukuk@thkukuk.de>.