---
title: Sauvegarde et restauration
description: Sauvegarder la base, le stockage privé et la configuration avec backup.sh, puis restaurer sur une pile neuve avec restore.sh.
---

# Sauvegarde et restauration

Deux scripts fournis protègent les données de l'instance : `backup.sh` produit une sauvegarde complète, `restore.sh` la restaure sur une pile neuve. Cette page décrit leur usage et les objectifs de reprise.

**Qui peut le faire :** l'exploitant, sur le serveur Docker, depuis une copie du dépôt source.

## Ce qui est sauvegardé

| Élément | Fichier | Remarque |
| --- | --- | --- |
| Base PostgreSQL | `postgres.dump` | Instantané cohérent, format restaurable par `pg_restore` |
| Rôles PostgreSQL | `roles.sql` | Sans mot de passe, pour référence |
| Stockage privé `platform-storage` | `storage.tar` | Avec propriétaires et droits |
| Configuration | `config.env` | Seulement si un fichier est fourni |
| Métadonnées | `backup.info` | Projet, date UTC, commit de l'image |
| Empreintes | `SHA256SUMS` | Vérifiées avant toute restauration |

Redis n'est pas sauvegardé : il n'est pas la source de vérité et se reconstruit depuis PostgreSQL.

Sur Coolify, la configuration vit dans la ressource. Exportez les variables vers le coffre de l'équipe à chaque changement. Sans ces valeurs, une base restaurée reste inaccessible.

## Sauvegarder

```bash
sh infra/compose/backup.sh <projet-compose> /chemin/neuf/2026-11-20 [fichier-env]
```

- `<projet-compose>` : sur Coolify, l'identifiant de la ressource, visible comme préfixe des conteneurs dans `docker ps`.
- Le dossier de sortie doit être **neuf**. Il est créé avec des droits privés (0700).
- Le script n'affiche ni données ni secrets : seulement des noms de fichiers, des tailles et des empreintes.

Ensuite :

1. Chiffrez le dossier, par exemple avec `age` ou `gpg`.
2. Copiez-le hors du serveur.

La sauvegarde est inscrite au journal des actions : `operations.backup` « demandé » avant l'instantané, puis « réussi ». Si le service web est arrêté, la sauvegarde se poursuit et le script indique l'entrée à rejouer avec `infra/compose/audit-operation.sh`.

### Fréquence proposée

- Une sauvegarde quotidienne planifiée (cron de l'hôte ou tâche planifiée Coolify), conservée 14 jours.
- Une sauvegarde manuelle avant chaque déploiement qui contient une migration.

## Restaurer

La restauration vise toujours une pile **neuve**. Le script refuse de remplacer une base existante.

> [!WARNING]
> Préparer une pile neuve dans le même projet suppose de supprimer les volumes existants, ce qui efface définitivement la base et le stockage en place. Vérifiez d'abord que la sauvegarde est complète et que ses empreintes sont valides. En cas de doute, restaurez dans une ressource neuve.

1. Restaurez la configuration à l'identique de la sauvegarde : variables Coolify depuis le coffre, ou fichier `config.env`. Les mots de passe des rôles doivent être les mêmes.
2. Démarrez une pile neuve, avec des volumes vides :

```bash
docker compose -p <projet> -f compose.mvp.yaml --env-file <env> up -d --wait postgres redis
docker compose -p <projet> -f compose.mvp.yaml --env-file <env> create web worker
```

3. Restaurez la base et le stockage. Le script vérifie les empreintes, compare la configuration et exige une base vide :

```bash
sh infra/compose/restore.sh <projet> <dossier-de-sauvegarde> <env>
```

4. Démarrez la pile. La release rejoue 0 migration et revérifie les droits du rôle runtime :

```bash
docker compose -p <projet> -f compose.mvp.yaml --env-file <env> up -d --wait
```

5. Inscrivez la restauration au journal des actions :

```bash
sh infra/compose/audit-operation.sh <projet> restore succeeded <dossier-de-sauvegarde>
```

6. Vérifiez `/readyz` à 200 et l'absence d'alerte **Journal d'audit indisponible** sur la page Exploitation.

La restauration de la base s'exécute en une seule transaction : un échec ne laisse pas de base partielle.

## Pendant un incident

1. Si la base répond encore et que des effets doivent cesser, activez l'[arrêt global](../06-administration-et-supervision/09-arret-global.md).
2. Restaurez comme ci-dessus.
3. Examinez la file de secours du journal avant de clore l'incident.
4. Levez l'arrêt global.
5. Recensez les écritures perdues depuis la sauvegarde : elles mesurent la perte réelle.

## Objectifs de reprise

| Objectif initial | Hypothèse |
| --- | --- |
| Perte de données maximale (RPO) : 24 heures | Sauvegarde quotidienne réussie, plus une sauvegarde avant chaque migration. |
| Durée de remise en service (RTO) : 8 heures | Exploitant disponible, sauvegarde et configuration accessibles. |

Ces valeurs sont des **objectifs**, pas des engagements de service. Une répétition sur une pile de test, avec une base de quelques mégaoctets, a pris quelques secondes. La durée réelle dépend du volume de données, du transfert de la sauvegarde chiffrée et de la disponibilité de l'exploitant. Mesurez-la sur votre propre instance.

## Essai de restauration

Faites un essai de restauration au moins une fois par mois, dans une ressource ou un projet Compose jetable. Une sauvegarde jamais restaurée n'est pas une sauvegarde vérifiée.

## Pour continuer

Préparez les mises à jour avec [Mises à jour et retour arrière](09-mises-a-jour-et-retour-arriere.md).
