Skip to main content

homebutler notify

Sends a test message through the notification channels you configured.

Channels are Telegram, Slack, Discord, a generic webhook, ntfy, and Gotify. Run the test before you rely on alerts or watch notifications.

For the channels and their settings, see Notifications.

CommandWhat it does
testSends one test notification through each configured provider and reports each result.

notify test​

Sends one test notification through each configured provider and reports each result.

homebutler notify test [flags]

The test is sent as a triggered alert, so it takes the same path a real alert takes. Providers that are not configured are skipped.

FlagTypeDefaultDescription
--alerts-configstring-Path to a legacy alerts YAML file whose notify settings are used when config.yaml has none.
homebutler notify test
Sending test notification...
✅ webhook: sent

With no notify settings at all, the command is an error.

homebutler notify test --config /home/you/min.yaml
error: no notification config found; configure notify in config.yaml or use --alerts-config for legacy alerts.yaml