Hear about problems
Leyla keeps a list of what needs you: a full disk, a paused download client, a backup that stopped. It looks every five minutes and tells you, whether or not you open the page. Everything goes straight from your server to the service you choose, and nothing passes through Leyla’s own infrastructure.
What rings
Open My Leyla › Notifications, on the web or in the app. Each category has a switch, and each kind of finding has one under it. These ring unless you change them:
- Everything marked Act now: failed scans, stale backups, a library folder that will not open, a failing drive, a database that is not up to date.
- Downloads that stopped or fail, Sonarr or Radarr not answering or refusing Leyla’s key, and an approved request that is stuck.
- A disk running out of room, files a scan stopped finding, and a job that is stuck.
- Somebody guessing passwords or usernames, an HTTPS certificate failing, the external database not answering, a hardware encoder taken out of use, and a notification channel that keeps failing.
The rest stays quiet until you switch it on: plugin updates, duplicate files, expired invitations, unknown config keys and the like. They are still on the page.
A finding rings once when it appears, and again only after it has cleared and come back. If a condition clears and returns within the hour it does not ring again, so a flapping mount cannot fill your phone.
How it rings
- Ring for
- Keeps out anything less severe than you choose.
- When
- As each one appears, or as one summary a day at a time you choose.
- Quiet hours
- Keep the night silent. What happened arrives as one message when they end. Act now findings can ring through if you say so.
More than three things at once are always one message that counts them, worst first. The first check on a new server is one message however much it finds. Nothing rings until the setup is finished.
Add a channel
Leyla has no phone push of its own, so ntfy, Gotify or Telegram is how your phone rings. Add channels under Administration › This server › Notifications, or in the setup. In the app, Manage this server opens the same page. You can run several at once, and each has its own switches.
| Kind | What it needs |
|---|---|
| ntfy | The topic’s address, like https://ntfy.sh/my-topic, and a token if the topic needs one |
| Gotify | The server’s address and an application token |
| Discord | A channel’s webhook address |
| Telegram | A bot token from @BotFather and a chat id |
| Your own mail server, its port and security, a user name and password if it wants them, and who the mail is from and to | |
| Webhook | Any address that takes JSON. Each message is signed with X-Leyla-Signature. |
Send a test answers straight away with how it went.
What leaves your server What a finding says, including file names, titles and addresses, goes to the service you chose. Choose accordingly.
Good to know
- Tokens, passwords and addresses are saved and never shown again.
- An address has to be public and https unless you tick This is on my own network, which also allows a mail server without encryption.
- A channel sends at most twelve messages an hour.
- A channel that fails shows on the list, and as a finding of its own in your bell and on your other channels. After three failures it is tried once an hour, with what it missed in one message, until a send or a test gets through.
Something missing or wrong here? Tell us.