Aller au contenu

Sauvegarde et restauration

KiwiDesk ne fait pas ses sauvegardes lui-même : c’est au serveur de les faire. Elles sont indispensables : les factures et clôtures de caisse doivent être conservées six ans, et une panne de disque ne prévient pas.

Deux choses sont à sauvegarder ensemble, au même moment :

  1. la base PostgreSQL (tickets, clients, factures, réglages, journal d’audit) ;
  2. le volume uploads (photos des appareils, pièces jointes, logos, médias des écrans, archives du journal d’audit dans .private/archives/audit/).

Gardez aussi, à part, le fichier .env et surtout ENCRYPTION_KEY : une sauvegarde restaurée sans la bonne clé ne permet plus de lire les codes de déverrouillage ni les mots de passe enregistrés.

Le script suivant, lancé chaque nuit par cron depuis le dossier de la stack, produit une copie de la base et une archive des fichiers, puis écrit le fichier témoin que KiwiDesk surveille.

/opt/kiwidesk/backup.sh
#!/bin/sh
set -eu
cd /opt/kiwidesk
STAMP=$(date -u +%Y%m%dT%H%M%SZ)
DEST=/srv/sauvegardes/kiwidesk
mkdir -p "$DEST"
# 1. Base de données (format compressé de pg_dump)
docker compose -f docker-compose.yml exec -T postgres \
sh -c 'pg_dump -U "$POSTGRES_USER" -d "$POSTGRES_DB" -Fc' > "$DEST/base-$STAMP.dump"
# 2. Volume des fichiers
docker compose -f docker-compose.yml exec -T api \
tar -czf - -C /app/uploads . > "$DEST/fichiers-$STAMP.tar.gz"
# 3. Témoin lu par Paramètres > À propos / Système
SIZE=$(du -cb "$DEST/base-$STAMP.dump" "$DEST/fichiers-$STAMP.tar.gz" | tail -1 | cut -f1)
NOW=$(date -u +%Y-%m-%dT%H:%M:%SZ)
docker compose -f docker-compose.yml exec -T api sh -c \
"mkdir -p /app/uploads/.private && printf '%s' '{\"finishedAt\":\"$NOW\",\"ok\":true,\"sizeBytes\":$SIZE}' > /app/uploads/.private/backup-last.json"
# 4. Garder 30 jours
find "$DEST" -type f -mtime +30 -delete

Ligne cron (tous les jours à 2 h 15) :

15 2 * * * /opt/kiwidesk/backup.sh >> /var/log/kiwidesk-backup.log 2>&1

Copiez ensuite le dossier des sauvegardes hors du serveur (autre machine, NAS, stockage objet) : une sauvegarde sur le même disque ne protège ni d’une panne, ni d’un vol, ni d’un rançongiciel.

La section Santé de l’instance de Paramètres > À propos / Système lit le fichier .private/backup-last.json du volume des fichiers :

{ "finishedAt": "2026-11-20T02:14:00Z", "ok": true, "sizeBytes": 734003200 }
Situation Affichage dans « Dernière sauvegarde »
Fichier absent Inconnue : aucun fichier témoin écrit par votre outil
Dernière sauvegarde de moins de 36 heures Correct
Plus de 36 heures Avertissement
Plus de 7 jours, ou "ok": false Erreur

Le dossier .private n’est jamais servi par l’adresse publique /uploads/.

Restaurez toujours une base et une archive de fichiers prises au même moment, sur la même version de KiwiDesk (ou une version plus ancienne que celle qui tourne : les migrations la mettront à niveau au démarrage).

  1. Arrêter l’application, en laissant la base démarrée :

    Fenêtre de terminal
    docker compose -f docker-compose.yml stop web api
  2. Vider et recréer la base, puis y charger la sauvegarde :

    Fenêtre de terminal
    docker compose -f docker-compose.yml exec -T postgres \
    sh -c 'dropdb -U "$POSTGRES_USER" --if-exists "$POSTGRES_DB" && createdb -U "$POSTGRES_USER" "$POSTGRES_DB"'
    docker compose -f docker-compose.yml exec -T postgres \
    sh -c 'pg_restore -U "$POSTGRES_USER" -d "$POSTGRES_DB" --no-owner' < base-20261120T021500Z.dump
  3. Restaurer les fichiers dans le volume uploads, avec un conteneur temporaire de l’API (il tourne sous le même utilisateur que l’API, les fichiers gardent donc le bon propriétaire) :

    Fenêtre de terminal
    docker compose -f docker-compose.yml run --rm --no-deps -v "$PWD":/backup \
    --entrypoint sh api -c \
    'rm -rf /app/uploads/* /app/uploads/.private && tar -xzf /backup/fichiers-20261120T021500Z.tar.gz -C /app/uploads'
  4. Vérifier ENCRYPTION_KEY : le fichier .env doit contenir la clé en service au moment de la sauvegarde.

  5. Redémarrer : docker compose -f docker-compose.yml up -d, puis contrôlez Paramètres > À propos / Système et ouvrez quelques tickets et factures récents.

Une sauvegarde jamais restaurée n’est pas une sauvegarde. Une fois par trimestre, restaurez la dernière sur une machine de test (une seconde stack avec un autre nom et un autre port) et vérifiez que vous retrouvez les derniers tickets, factures et photos.