Alerts
One inbox for every alert in Termix, with delivery to the mobile app, webhooks, ntfy, Discord and email.
- One inbox for alerts from every part of Termix
- Popups for new alerts
- Send alerts to Discord, Slack, Teams, Telegram, ntfy, Gotify, Pushover, Matrix, email or a webhook
- Push notifications on your phone through the Termix app
- Rules that pick which alerts go where
- Optional news from the Termix team, like security notices and releases
- An alerts inbox card for the dashboard
Alerts is the one inbox for everything in Termix that wants your attention: an automation that failed, a certificate that didn't renew, a new Termix release. It can also send alerts on to your phone, Discord, Slack, Teams, Telegram, ntfy, Gotify, Pushover, Matrix, email or any webhook.
Other plugins send alerts. Alerts is where they land.
The inbox
Open Alerts from the sidebar. Each alert has a severity (info, success, warning or critical), where it came from and when. Filter by unread, severity or source, and search.
New alerts also pop up while you use Termix. Pick which ones under Alert popups in Settings, Alerts: all, warnings and critical (the default), critical only, or none. They always land in the inbox either way.
Add the Alert Feed widget to your homepage to see the latest ones there.
On the dashboard
Add the Alerts card in the dashboard's edit mode to keep your inbox on the dashboard. It shows the same list as the Alerts panel.
Channels
A channel is somewhere outside Termix an alert can go. Add them under Channels:
| Type | You need |
|---|---|
| Webhook | A URL. Termix sends a JSON body for each alert. You can set the method and headers. |
| ntfy | A server URL and topic, plus a token if the topic is protected. |
| Discord | A webhook URL, from the Discord channel's settings under Integrations. |
| Telegram | A bot token from BotFather and the chat ID to post in. |
| Slack | An incoming webhook URL from the Incoming Webhooks app. |
| Teams | A workflow URL. In the channel, add the workflow Post to a channel when a webhook request is received. |
| Gotify | The server URL and an app token. |
| Pushover | An application token and your user or group key. |
| Matrix | The homeserver URL, a room ID like !abc:matrix.org, and the access token of an account in the room. |
| One or more addresses. An admin has to set up SMTP first. |
Send a test checks a channel works.
Phone notifications
In the Termix app, open Settings, Notifications and turn them on for a server. The phone shows up here as a Mobile app channel, with a rule named after the phone that sends warnings and worse to it. Change the lowest severity in the app, or edit the rule here to pick which alerts go to the phone. Turning it off in the app, or deleting the channel here, stops the notifications.
Notifications go through Expo's push service and Apple or Google, and carry the alert's title and text. The F-Droid build has no Google services, so it checks for new alerts in the background instead, about every 15 minutes.
Termix blocks sending to private network addresses by default. To send to something on your own network, like a self-hosted ntfy, Gotify or Matrix server, an admin adds the host to Allowed private notification hosts in Settings, General, and you turn on Allow a private network address on the channel.
Delivery rules
A rule picks which alerts go to which channels. Under Delivery rules, set:
- Alerts to send:
*for everything,automations.*for everything from Automations, or one exact kind. - At least: the lowest severity to send.
- Send to: one or more of your channels.
Without rules, alerts only show in the inbox.
Email
An admin sets up the mail server in Settings, Alerts:
| Setting | |
|---|---|
| SMTP server | Leave it empty to turn email off. |
| SMTP port | 587 for STARTTLS, 465 for TLS. |
| Use TLS from the start | On for 465, off for 587. |
| SMTP username, SMTP password | If the server needs a login. The password is stored encrypted. |
| From address | Who alerts come from. |
Termix announcements
With Termix announcements on, news from the Termix team, like security notices and new releases, shows up in the inbox. You only get news from after you joined, so a new account starts with a clean inbox. Some come with buttons, and an important one can also show as a card on screen until you close it. Delete one and it won't come back. Admins can turn announcements off.
Keeping alerts
Alerts older than Keep alerts for (days), 90 by default, are removed from every inbox.
For plugin authors
Send an alert with ctx.notify.send() and the notify:send capability. Pick an audience, a severity and a kind, like hello.thing_failed. You never talk to this plugin directly, and your alerts work with or without it installed. See backend.