server-up/docs
Ramon 87fb9d19d1
All checks were successful
Deploy server-up (dev) / deploy (push) Successful in 1m22s
v0.7.50-beta - meldingen, schijfruimte, backups controleren en extern wegzetten
Het onbewaakte deel was de zwakke plek: geplande taken draaiden 's nachts en
een storing kwam alleen in het auditlog terecht.

Meldingen (core/notify.py):
- ntfy, webhook (Discord/Slack/Gotify) en e-mail, alle drie met de
  standaardbibliotheek.
- Gebeurtenissen: mislukte backup, onleesbaar archief, vastgelopen taak,
  weinig schijfruimte, beschikbare update, gestopte container.
- Eén bericht per ronde; bij schijfruimte en gestopte containers alleen bij
  de overgang, zodat je niet elk uur hetzelfde krijgt.
- Testknop die eerst opslaat, zodat je test wat je net hebt ingevuld.
- send() gooit nooit: het kanaal mag de taak die de melding veroorzaakte niet
  alsnog laten omvallen.

Schijfruimte (core/diskspace.py):
- Controle vóór elke backup; past het niet, dan weigeren in plaats van
  halverwege afbreken.
- DISK_MIN_FREE_GB blijft gereserveerd, DISK_WARN_PCT kleurt de balk rood.
- Per filesystem één regel in de backuplijst.

Backups controleren:
- Elk nieuw archief wordt helemaal uitgelezen (tar-structuur plus
  gzip-checksum, die aan het eind staat).
- Diepe variant pakt echt uit naar een tijdelijke map, met dezelfde
  beperkingen als een echt herstel.
- Resultaat staat in de metadata en als schildje in de lijst.

Backups de deur uit:
- Downloadknop.
- BACKUP_OFFSITE_DIR kopieert elke nieuwe backup naar een gemounte schijf,
  NFS- of SMB-share, via .part zodat een afgebroken kopie herkenbaar onaf is.
- Ruimtecontrole op de bestemming, want een weggevallen mount laat vaak een
  lege map op de systeemschijf achter.

NOTIFY_TOKEN en NOTIFY_EMAIL_PASSWORD zijn write-only.

Nieuw: docs/meldingen.md; docs/backups.md uitgebreid. Getest tegen een
draaiende server met een echte ontvanger. 1064 tests groen.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01C7oLCRYzY5ixJ5Sv8Y8EFb
2026-07-28 19:41:35 +02:00
..
apps-maken.md v0.7.20-beta - instellingen wijzigen, koppelen achteraf, defect uit v0.7.00 2026-07-27 15:43:49 +02:00
backups.md v0.7.50-beta - meldingen, schijfruimte, backups controleren en extern wegzetten 2026-07-28 19:41:35 +02:00
beveiliging.md .env.example toevoegen met alle instellingen erin 2026-07-26 23:35:11 +02:00
forgejo-actions-setup.md v0.3.1 - UI restyle, inklapbaar menu, taalmodule 2026-06-02 23:25:30 +02:00
installeren.md v0.7.40-beta - beheerdersaccount en bind meteen klaarzetten 2026-07-27 21:13:06 +02:00
meldingen.md v0.7.50-beta - meldingen, schijfruimte, backups controleren en extern wegzetten 2026-07-28 19:41:35 +02:00
netwerken.md v0.5.40-beta - netwerken instellen zonder uitzoekwerk 2026-07-26 23:16:52 +02:00
README.md v0.7.50-beta - meldingen, schijfruimte, backups controleren en extern wegzetten 2026-07-28 19:41:35 +02:00
synchroniseren.md v0.3.1 - UI restyle, inklapbaar menu, taalmodule 2026-06-02 23:25:30 +02:00
updates.md Duidelijker maken waarom de updateknop uit staat bij een zelfgebouwd image 2026-07-26 23:23:30 +02:00

Documentatie

Document Waarover, en wanneer je het nodig hebt
installeren.md Installeren met één regel, alle opties van het script, bijwerken en verwijderen.
beveiliging.md Accounts, rollen, reverse-proxy-SSO en TLS. Lees dit voordat je Server Up van buiten je netwerk bereikbaar maakt — toegang tot de interface staat gelijk aan root op de host.
apps-maken.md Eigen apps toevoegen: het volledige template.json-formaat, de compose-syntaxis, apps aan elkaar koppelen en onderdelen optioneel maken.
netwerken.md Stacks een eigen IP-adres geven in je LAN met macvlan of ipvlan. Inclusief de valkuil dat de host zijn eigen macvlan-containers niet bereikt.
backups.md Wat er wél en niet in een backup zit, terugzetten, bewaarbeleid, geplande backups, controleren, downloaden en een tweede bestemming.
meldingen.md Bericht krijgen als er 's nachts iets misgaat: ntfy, webhook of e-mail, en waarover je gemeld wilt worden.
updates.md Update-kanalen (stable en beta), bijwerken vanuit de interface, en de Forgejo-registry inrichten.
synchroniseren.md Code van je eigen apparaat automatisch naar de server krijgen via Forgejo.
forgejo-actions-setup.md De act_runner installeren en instellen.

Zie ../README.md voor installeren en een overzicht van wat Server Up doet.