server-up/docs/meldingen.md

Meldingen

Geplande backups, de updatecheck en de bewaking van je containers draaien in de achtergrond, meestal 's nachts. Zonder meldingen komt een storing alleen in het auditlog terecht — en dat lees je pas als je al een probleem hebt. Een backup die drie weken stilletjes faalt, ontdek je op het slechtst denkbare moment.

Instellen doe je onder Instellingen → Meldingen.

---

Kanalen

Alle drie werken met wat er al in Server Up zit; er komt geen extra software of account aan te pas.

ntfy

Het eenvoudigst als je iets op je telefoon wil. Installeer de ntfy-app, verzin een topicnaam die niet te raden is, en vul de URL in:

https://ntfy.sh/serverup-a7f3k9x2

Iedereen die de topicnaam kent kan meelezen én zelf berichten sturen, dus kies iets willekeurigs. Draai je een eigen ntfy-server met toegangscontrole, vul dan ook het token in; dat gaat mee als Authorization: Bearer ….

Webhook

Een POST met een JSON-body. Dezelfde instelling werkt voor Discord, Slack, Gotify en zelfgebouwde ontvangers: de body bevat naast title en message ook content (wat Discord leest) en text (wat Slack leest).

{
  "title":   "1 backup(s) mislukt",
  "message": "De geplande backup is niet gelukt voor:\n\n• vaultwarden: …",
  "content": "**1 backup(s) mislukt**\n…",
  "text":    "*1 backup(s) mislukt*\n…",
  "priority": "hoog",
  "source":  "server-up"
}

Voor Discord gebruik je de webhook-URL uit Kanaalinstellingen → Integraties.

E-mail

SMTP met STARTTLS (standaard), SSL/TLS of onversleuteld. Vul server, poort, gebruikersnaam, wachtwoord, afzender en ontvanger in.

Gebruik je Gmail of Microsoft 365, dan heb je een app-wachtwoord nodig; je gewone wachtwoord wordt geweigerd.

---

Waarover je bericht krijgt

Gebeurtenis	Wanneer
backup_failed	Een geplande backup is voor een of meer stacks mislukt
backup_verify	Een archief bleek niet leesbaar bij de controle
job_failed	Een geplande taak liep vast
disk_low	Een schijf zakte onder de ingestelde drempel
update_available	Er staat een nieuwe versie klaar
stack_down	Een container die zou moeten draaien, draait niet meer

Standaard staan alleen de storingen aan. "Update beschikbaar" is nuttig maar geen probleem, dus die vink je zelf aan.

Er komt één bericht per ronde, niet één per stack: bij een volle schijf faalt alles tegelijk en dan wil je geen twintig meldingen. Voor disk_low en stack_down wordt alleen de overgang gemeld — anders krijg je elk uur hetzelfde bericht tot je het oplost.

---

Testen

Met Test versturen stuurt Server Up meteen een bericht via het ingestelde kanaal. De instellingen worden eerst opgeslagen, zodat je test wat je net hebt ingevuld en niet de vorige waarden.

Komt het niet aan, dan staat de foutmelding erbij: een HTTP-code bij ntfy en webhooks, de SMTP-fout bij e-mail. Elke poging komt ook in het auditlog onder bron notify, dus je kunt teruglezen of er gemeld is — en of dat lukte.

---

Wat er níét gebeurt

Een storing in het meldingskanaal mag nooit de taak omvergooien die de melding veroorzaakte. Mislukt het versturen, dan gaat de backup gewoon door en vind je het terug in het auditlog. Een onbereikbare ntfy-server maakt dus geen kapotte backup.

---

Instellingen

Sleutel	Standaard	Betekenis
NOTIFY_CHANNEL	leeg	ntfy, webhook, email, of leeg voor uit
NOTIFY_URL	leeg	Topic- of webhook-URL
NOTIFY_TOKEN	leeg	Bearer-token; wordt nooit teruggegeven door de API
NOTIFY_EVENTS	storingen	Lijst met gebeurtenissen hierboven
NOTIFY_EMAIL_HOST	leeg	SMTP-server
NOTIFY_EMAIL_PORT	587	SMTP-poort
NOTIFY_EMAIL_SECURITY	starttls	starttls, ssl of geen
NOTIFY_EMAIL_USER	leeg	Gebruikersnaam
NOTIFY_EMAIL_PASSWORD	leeg	Wachtwoord; wordt nooit teruggegeven
NOTIFY_EMAIL_FROM	leeg	Afzender
NOTIFY_EMAIL_TO	leeg	Ontvanger
STACK_DOWN_CHECK	true	Containers bewaken die zouden moeten draaien

Het token en het SMTP-wachtwoord zijn write-only: je kunt ze instellen, maar de API geeft ze nooit terug — alleen of ze gevuld zijn. Een leeg veld betekent bij het opslaan "niet wijzigen", net als bij de git-tokens.