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 :
- la base PostgreSQL (tickets, clients, factures, réglages, journal d’audit) ;
- 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.
Sauvegarder
Section intitulée « Sauvegarder »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.
#!/bin/shset -eucd /opt/kiwideskSTAMP=$(date -u +%Y%m%dT%H%M%SZ)DEST=/srv/sauvegardes/kiwideskmkdir -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 fichiersdocker 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èmeSIZE=$(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 joursfind "$DEST" -type f -mtime +30 -deleteLigne cron (tous les jours à 2 h 15) :
15 2 * * * /opt/kiwidesk/backup.sh >> /var/log/kiwidesk-backup.log 2>&1Copiez 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.
Le fichier témoin
Section intitulée « Le fichier témoin »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/.
Restaurer
Section intitulée « Restaurer »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).
-
Arrêter l’application, en laissant la base démarrée :
Fenêtre de terminal docker compose -f docker-compose.yml stop web api -
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 -
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' -
Vérifier
ENCRYPTION_KEY: le fichier.envdoit contenir la clé en service au moment de la sauvegarde. -
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.
Tester une restauration
Section intitulée « Tester une restauration »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.