Notifications
You can receive notifications about failed (and optionally successful) renewals via email by configuring the required SMTP server details in settings.json. You can test these notifications from the menu (More options... > Test notification).
You can also configure a script to run to send you notifications, enabling more direct integration with third party communication or monitoring platforms. Examples of such scripts may be available in the reference scripts repository. Contributions are most welcome!
It is possible to implement additional forms of notification (i.e. Slack, Discord, Teams, Jira, ...) using C# by implementing the INotificationTarget interface. Contributions in this area are most welcome!
Settings
Notification.ComputerName |
This value replaces the computer machine name reported in notifications.
Type: string Default: null |
|||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
Notification.Email.SmtpServer |
SMTP server to use for sending email notifications. Required to receive renewal failure notifications.
Type: string Default: null |
|||||||||||
Notification.Email.SmtpPort |
SMTP server port number.
Type: number Default: 25
|
|||||||||||
Notification.Email.SmtpUser |
User name for the SMTP server, in case of authenticated SMTP.
Type: string Default: null |
|||||||||||
Notification.Email.SmtpPassword |
Password for the SMTP server, in case of authenticated SMTP.
You don't have to store a literal password here, but may also place a reference to the secret vault like Default: null |
|||||||||||
Notification.Email.SmtpSecure |
Change to true to enable secure SMTP.
Type: boolean Default: false
|
|||||||||||
Notification.Email.SmtpSecureMode |
Control the way the connection with the mail server is established. Only change this if you run into connection issues.
Type: number Default: 1
|
|||||||||||
Notification.Email.SenderName |
Display name to use as the sender of notification emails.
Type: string Default: null (equivalent to {Client.ClientName})
|
|||||||||||
Notification.Email.SenderAddress |
Email address to use as the sender of notification emails. Required to receive renewal notifications.
Type: string Default: null |
|||||||||||
Notification.Email.ReceiverAddresses |
Email address to use as the sender of notification emails. Required to receive renewal failure notifications. The correct format for the receiver is ["example@example.com"] for a single address and ["example1@example.com", "example2@example.com"] for multiple addresses.
Type: string[] Default: null |
|||||||||||
Notification.Email.NotifyOnSuccess |
Send an email notification when a certificate has been successfully created or renewed, as opposed to the default behavior that only send failure notifications. Only works if at least SmtpServer, SmtpSenderAddress andSmtpReceiverAddress have been configured.
Type: boolean Default: false
|
|||||||||||
Notification.Script.Path |
Path to external script or program to run for notifications. Supported extensions: .ps1, .sh, .exe, .bat, .cmd (Windows only).
Type: string Default: null |
|||||||||||
Notification.Script.Parameters |
Parameters for the notification script. May include tokens like {EventType} (created, success, success-with-errors, failure, cancel, test), {RenewalId}, {FriendlyName}, {Errors}, {Log} (base64-encoded), and {vault://json/key} for secrets.
Type: string Default: null |
|||||||||||
Notification.Script.NotifyOnSuccess |
Send a script notification when a certificate has been successfully created or renewed, as opposed to the default behavior that only sends failure notifications.
Type: boolean Default: false
|
Looking for win-acme?
simple-acme is a backwards compatible, drop-in replacement built by the same person. Project history.