# Sauvegardes

> backup ls, create, restore, rm

Une sauvegarde est une **copie des fichiers** du service, prise à un instant, gardée
à côté. Elle sert à revenir en arrière après une fausse manœuvre : un plugin qui
casse tout, un monde abîmé, un fichier de configuration perdu.

<Note>
  Une sauvegarde n'est pas un instantané. L'instantané fige le disque entier d'une
  instance ; la sauvegarde ne prend que les fichiers. Voir
  [Sauvegardes et instantanés](/guides/sauvegardes-et-instantanes).
</Note>

## ark backup ls

```bash
ark backup ls survie-2026
ark backup ls survie-2026 --json
```

```
nom                état   taille   créée             identifiant
avant-maj          prête  1.4 Go   2026-09-16 09:02  b3f1…
quotidienne-0916   prête  1.4 Go   2026-09-16 04:00  8a2c…
avant-plugin       en cours  —     2026-09-17 10:11  c91e…
```

| État | Ce qu'il veut dire |
| --- | --- |
| en cours | La copie se fait. Attends avant de compter dessus. |
| prête | Elle est complète et restaurable. |
| restauration | Elle est en train d'être remise en place. |
| échouée | La copie n'a pas abouti. Relance-la. |

## ark backup create

```bash
ark backup create survie-2026 avant-maj
ark backup create survie-2026
```

Sans nom, le CLI en fabrique un à partir de la date : `ark-20260917T1011`.

```
- sauvegarde « avant-maj » de survie-2026
ok sauvegarde lancée
```

La commande rend la main dès que la copie est lancée — elle ne bloque pas jusqu'à la
fin. Relance `ark backup ls` pour voir passer l'état de « en cours » à « prête ».

### Ignorer des fichiers

```bash
ark backup create survie-2026 legere --ignore "logs/*
cache/*
*.tmp"
```

Un motif par ligne, comme un `.gitignore`. Pratique pour ne pas embarquer quarante
gigaoctets de journaux.

## ark backup restore

```bash
ark backup restore survie-2026 avant-maj
```

```
Restaurer « avant-maj » écrase les fichiers de survie-2026. On y va ? [o/N]
```

La sauvegarde se désigne par son nom ou par son identifiant. `--yes` saute la
question.

<Warning>
  La restauration **écrase** les fichiers actuels. Ce que tu as écrit depuis la
  sauvegarde est perdu. Si tu hésites, prends une sauvegarde de l'état actuel avant de
  restaurer l'ancienne.
</Warning>

Arrête le service avant de restaurer : un processus qui écrit pendant qu'on remplace
ses fichiers sous lui donne rarement un bon résultat.

```bash
ark stop survie-2026
ark backup restore survie-2026 avant-maj --yes
ark start survie-2026
```

## Nommer le service autrement

Le service se met juste après le verbe. `--service` le sort de la ligne quand un nom
de sauvegarde prêterait à confusion :

```bash
ark backup create --service survie-2026 avant-maj
ark backup ls --service survie-2026
```

## ark backup rm

```bash
ark backup rm survie-2026 quotidienne-0901
```

Les sauvegardes occupent de la place et comptent dans ce que tu payes. Faire le
ménage de temps en temps est un bon réflexe.