# Instantanés

> snapshot ls, create, rollback, rm

Un instantané fige **le disque entier** d'une instance ou d'une machine virtuelle à
un instant. Revenir dessus remet la machine exactement dans cet état : paquets
installés, configuration système, fichiers.

C'est le filet à prendre avant une mise à jour système ou une manipulation qu'on ne
sait pas défaire.

## ark snapshot ls

```bash
ark snapshot ls runner-ci
ark snapshot ls runner-ci --json
```

```
nom           taille   pris le           description
avant-maj     18.2 Go  2026-09-16 09:02  avant montée en 24.04
sortie-usine  6.1 Go   2026-09-01 10:00  
```

## ark snapshot create

```bash
ark snapshot create runner-ci avant-maj
ark snapshot create runner-ci avant-maj --note "avant montée en 24.04"
```

Le nom n'accepte que des lettres, des chiffres, des tirets et des tirets bas, et doit
commencer et finir par une lettre ou un chiffre. Quarante caractères au plus.

## ark snapshot rollback

```bash
ark snapshot rollback runner-ci avant-maj
```

```
Revenir à « avant-maj » remet runner-ci dans l'état de ce jour-là. On y va ? [o/N]
```

<Warning>
  Tout ce qui a été écrit depuis l'instantané disparaît. Le disque entier revient en
  arrière, pas seulement les fichiers que tu as en tête.
</Warning>

## ark snapshot rm

```bash
ark snapshot rm runner-ci sortie-usine
```

Un instantané occupe de la place sur le stockage du nœud, et cette place est
facturée. Garde-en peu, et récents.

## Qui a des instantanés

Les instances (`ACI`) et les machines virtuelles (`AVM`). Un serveur de jeu, non :
il a des [sauvegardes](/cli/backup), qui ne couvrent que ses fichiers. `ark info` te
dit lequel des deux ton service accepte.

```bash
ark info runner-ci
```

```
peut : console, snapshots, snapshotRollback, powerSignals, suspension
```