← Alle tools
Beheer · technici · maandelijks

Serveronderhoud

Onze twee servers (hdvp-app en hdvp-store) krijgen elke eerste vrijdag van de maand, begin van de avond een automatische onderhoudsronde: updates, nieuwe container-images en waar nodig een herstart. Daarna controleert de server zichzelf en meldt het resultaat via ntfy. Vrijdag is bewust gekozen: gaat er iets mis, dan is er het weekend om het op te lossen zonder dat productie erop wacht.

Technici 1e vrijdag · store 18:30 · app 19:15 status.hdvp.nl
Basis / Wat er gebeurt

De ronde, stap voor stap

De opslagserver gaat eerst (18:30), de applicatieserver drie kwartier later (19:15) — zo staan NFS en MinIO alweer als de app-server herstart. Reken op 5–10 minuten onbereikbaarheid van Nextcloud, FreeFrame, login en de websites rond 19:15–19:30. Plan er geen livestream of oplevering in.

StapWatWaarom
0Wachten op lopende opleveringen (max 45 min)Een Whisper-transcriptie van een uur niet halverwege afbreken
1apt full-upgrade + opruimenSysteempakketten, kernel, Docker
2Container-images vernieuwen per stack (compose pull + up)Caddy, web-stack, FreeFrame, ntfy, n8n, Paperless, Ontime … — niet Nextcloud en Authentik: die doen we met de hand (major-versies)
3Samenvatting naar ntfyJe ziet op je telefoon wat er is gebeurd
4Herstart als de server dat vraagtNieuwe kernel/libc worden pas actief na een reboot
5Zelfcontrole 3 min na de boot → rapport ✅ of ⚠Containers terug, diensten, schijf, endpoints, ZFS ontgrendeld

Beveiligingsupdates wachten niet op deze ronde: unattended-upgrades installeert die dagelijks (zonder herstart — de herstart komt op de eerste vrijdag).

Stap voor stap / Jouw deel

Wat jij doet

Rapport lezen (±19:45)

Je krijgt per server twee meldingen: "Onderhoud … : herstart" (of klaar) met de samenvatting, en daarna "Verificatie … : alles in orde ✅". Check daarnaast even status.hdvp.nl: alles groen, updates 0, uptime begint opnieuw. Log in op cloud.hdvp.nl. Klaar.

Bij een ⚠

Het rapport noemt de punten. De meest voorkomende: een container die niet terug is (sudo docker ps -a, dan docker compose -f /opt/stacks/<stack>/compose.yml up -d), Nextcloud in maintenance-mode (occ maintenance:mode --off in de app-container), /mnt/store niet gemount (store nog niet op, of tank niet ontgrendeld → eerst de store checken), of Caddy die na een image-update z'n config niet pakt (sudo docker restart caddy). Het volledige logboek staat in /var/log/hdvp-onderhoud/JJJJ-MM.log.

Buiten de planning

Eerst kijken zonder iets te veranderen: sudo hdvp-onderhoud.sh --dry-run. Echte ronde zonder herstart: sudo hdvp-onderhoud.sh --no-reboot. Alleen controleren: sudo hdvp-verifieer.sh. Eerstvolgende geplande ronde: systemctl list-timers hdvp-onderhoud.timer.

Eens per kwartaal, met de hand

Nextcloud en Authentik bijwerken (release notes lezen, backup checken, dan compose pull + up -d; Nextcloud doet z'n database-upgrade bij het opstarten). Hersteltest van de backup (één bestand terughalen uit restic, zoals op 21-08). Oude SSH-sleutels en tijdelijke accounts opruimen. Toegangsmatrix nalopen (1 november staat al vast). Proxmox op de TC-1-set en jb-ingest meenemen als ze aan staan.

Checklist · na de maandronde

Checklist · kwartaal (jan · apr · jul · okt)

Let op: plan geen livestream, opname-oplevering of showdag op de eerste vrijdagavond van de maand. Valt die avond toch op een event, zet dan de timer die maand uit met sudo systemctl stop hdvp-onderhoud.timer en draai de ronde later handmatig.
Changelog / Per wijziging

Wat is nieuw

5 sep 2026
Maandelijkse onderhoudsronde ingerichtNieuw
Scripts hdvp-onderhoud.sh en hdvp-verifieer.sh met systemd-timer op de eerste vrijdag van de maand, zelfcontrole na de reboot en ntfy-rapport. Dagelijkse security-updates via unattended-upgrades. Aanleiding: 5 openstaande Docker-updates en een reboot die 40 dagen wachtte.
Spiekbrief / Op één scherm

Snel naslaan

Wanneer
1e vrijdag van de maand · store 18:30 · app 19:15 · ±10 min hinder rond 19:15–19:30
Rapport
ntfy: "Onderhoud …" + "Verificatie …" per server · status.hdvp.nl
Scripts
/usr/local/bin/hdvp-onderhoud.sh · hdvp-verifieer.sh · config /etc/hdvp/onderhoud.env
Log
/var/log/hdvp-onderhoud/JJJJ-MM.log
Handmatig blijft
Nextcloud + Authentik (kwartaal) · hersteltest · sleutels · matrix
Code
GitHub hdvp-infra/onderhoud/ · Nextcloud HDVP Server/hdvp-infra-push/onderhoud/