Restaurer une application depuis la sauvegarde de la nuit

La sauvegarde automatique de Mon serveur crée chaque nuit une archive par application. Voici comment remettre une seule application dans l’état d’une de ces nuits, sans toucher aux autres. Exemple avec Vaultwarden.

1. Choisir l’archive

ls -lh /opt/backups/vaultwarden_*

Prenez la dernière archive d’avant le problème. Si l’application est cassée depuis mardi soir, prenez celle de mardi (faite à 3 h, donc avant).

2. Arrêter l’application

cd /opt/stacks/vaultwarden
sudo docker compose down

3. Mettre l’état actuel de côté

On ne supprime rien : on renomme. Si la restauration ne convient pas, vous pourrez revenir en arrière.

cd /opt/stacks
sudo mv vaultwarden vaultwarden.avant-restauration

4. Extraire l’archive

L’archive contient le dossier vaultwarden entier, avec les bons propriétaires de fichiers :

sudo tar xzpf /opt/backups/vaultwarden_2026-10-09.tgz -C /opt/stacks
ls -la /opt/stacks/vaultwarden

L’option p conserve les droits d’origine des fichiers : important pour les applications qui ne tournent pas en root.

5. Redémarrer et vérifier

cd /opt/stacks/vaultwarden
sudo docker compose up -d
sudo docker compose logs -f      # Ctrl+C pour quitter

Ouvrez l’application et vérifiez que vos données sont bien celles attendues. Si la page affiche « 404 page not found » pendant la première minute, patientez : Traefik attend que l’application ait passé son auto-test de démarrage.

6. Faire le ménage

Quand tout est bon (attendez quelques jours si vous voulez être prudent) :

sudo rm -rf /opt/stacks/vaultwarden.avant-restauration

Pour revenir en arrière, faites l’inverse : docker compose down dans le dossier restauré, supprimez-le, renommez vaultwarden.avant-restauration en vaultwarden, puis docker compose up -d.

Récupérer un seul fichier

Pas besoin de tout restaurer pour retrouver un fichier : extrayez l’archive dans un dossier temporaire et piochez.

mkdir /tmp/restau
sudo tar xzf /opt/backups/paperless_2026-10-09.tgz -C /tmp/restau
sudo ls /tmp/restau/paperless/media/documents/originals/
# … copiez ce qu'il vous faut, puis :
sudo rm -rf /tmp/restau

Après une mise à jour qui a cassé l’application

Si le problème vient d’une mise à jour, restaurer les données ne suffit pas toujours : la nouvelle version risque de les re-modifier au démarrage. Bloquez d’abord l’ancienne version dans le compose.yml (voir mettre à jour sans rien casser), puis restaurez.

Le test trimestriel (10 minutes)

Une fois par trimestre, vérifiez que vos sauvegardes se restaurent vraiment, sans toucher à la production :

mkdir /tmp/test-restau
sudo tar xzf /opt/backups/vaultwarden_$(date +%F).tgz -C /tmp/test-restau
sudo ls -la /tmp/test-restau/vaultwarden/data
sudo rm -rf /tmp/test-restau

Les fichiers sont là, avec une taille cohérente ? Votre sauvegarde est bonne. Pour un test complet, restaurez sur un petit serveur de test et lancez l’application.

Et si le serveur entier est perdu ?

Les archives de /opt/backups disparaissent avec lui : c’est pour ça qu’il faut les copier ailleurs. Avec une copie, la reconstruction prend une demi-heure : nouveau serveur, script de Mon serveur avec le même panier, puis restauration de chaque application comme ci-dessus. Le guide migrer son serveur détaille la méthode.

Une commande qui ne marche pas, une explication pas claire ? Signaler une erreur dans cette page.