Notifications

DockDash uses the Apprise REST API to deliver notifications to Slack, Discord, Telegram, email, and many other services.

Notifications can be emitted when:

• A service goes down or recovers
• A container image update becomes available
• CPU or memory remains above a configured threshold
• A resource spike clears
• A TLS certificate approaches expiry, fails validation, recovers, or is renewed
• A deployed certificate differs from CertVault, or that mismatch is resolved

Container update notifications include the matching GitHub release URL beneath each version change when the repository and release tag can be resolved. Updates without a matching release, including digest-only updates, still send the version notification without a link. A failed GitHub lookup does not prevent delivery.

Configure the endpoint

Variable	Default	Description
APPRISE_URL	unset	Apprise REST notification endpoint
APPRISE_TAGS	unset	Comma-separated Apprise routing tags
APPRISE_URLS	unset	Comma-separated inline Apprise notification URLs

Set the complete Apprise notify endpoint:

APPRISE_URL=http://apprise:8000/notify/apprise

In Apprise’s stateful mode, the final path segment is the configuration key.

Use tags to select matching endpoints from the Apprise configuration:

APPRISE_TAGS=admin,homelab

Additional inline targets can be supplied with APPRISE_URLS:

APPRISE_URLS=discord://webhook_id/webhook_token

All three settings can be combined.

Caution

Notification URLs commonly contain credentials. Store them in deployment secrets and never include them in issues, screenshots, logs, or commits.

Resource thresholds

Variable	Default	Description
CPU_SPIKE_THRESHOLD	90	CPU percentage that triggers an alert; 0 disables it
MEMORY_SPIKE_THRESHOLD	90	Memory percentage that triggers an alert; 0 disables it
SPIKE_DURATION_THRESHOLD	300	Seconds a spike must persist before alerting; 0 alerts immediately

Set percentage thresholds and the duration they must persist:

CPU_SPIKE_THRESHOLD=90
MEMORY_SPIKE_THRESHOLD=90
SPIKE_DURATION_THRESHOLD=300

A threshold of 0 disables that resource alert. A duration of 0 alerts immediately.

After saving the settings, use Send Test in DockDash to verify the complete delivery path.

Certificate monitoring

Certificate monitoring applies to services explicitly configured with the HTTPS protocol. Its state is persisted, so DockDash only notifies when a certificate changes state or crosses another expiry threshold—not on every check or application restart.

Variable	Default	Description
CERTIFICATE_CHECK_INTERVAL	21600000	Certificate check interval in milliseconds (6 hours)
CERTIFICATE_EXPIRY_THRESHOLDS	30,14,7,3,1	Comma-separated expiry warning thresholds in days; 0 disables expiry warnings

Certificate validation errors, recovery, and renewal notifications remain enabled whenever Apprise is configured. When CertVault is configured, DockDash also reports deployment mismatches and their resolution.