---
title: "SLV Backup - Démarrage rapide"
description: "Créez des sauvegardes chiffrées et incrémentales de votre nœud Solana avec SLV backup."
canonical: "https://erpc.global/fr/doc/backup/quickstart/"
locale: "fr"
---

# SLV Backup - Démarrage rapide

## 🗄️ SLV Backup

SLV Backup crée des **sauvegardes chiffrées et incrémentales** de votre nœud à l'aide de [restic](https://restic.net/). Toutes les données sont chiffrées côté client en AES-256 avant l'envoi — le serveur ne voit jamais vos données en clair.

> **Mode hérité** : SLV prend aussi en charge les sauvegardes tar+zstd non chiffrées (sans `--restic`). Nous recommandons vivement d'utiliser `--restic` pour toutes les nouvelles sauvegardes.

### Prérequis

- SLV CLI installé sur le nœud cible
- Accès `sudo` (requis pour la sauvegarde complète du disque)
- Connexion effectuée (`slv login`) avec un abonnement de stockage actif
- `restic` installé (`apt install restic`)

## Créer une sauvegarde chiffrée

```bash
sudo slv backup create --restic --yes
```

```
🗄️  SLV Backup (restic mode)

  Region:    default
  Retention: 7 days

⚠️  Restic encryption password generated and saved to:
   /home/solv/.slv/restic-password
   BACK UP THIS FILE — without it, backups cannot be restored.

🔧 Initializing restic repository (if needed)...
📦 Creating restic backup...

Files:       151263 new,     0 changed,     0 unmodified
Dirs:        22486 new,     0 changed,     0 unmodified
Added to the repository: 4.107 GiB (1.837 GiB stored)

processed 151263 files, 4.366 GiB in 0:50
snapshot b6925e6d saved

✅ Restic backup complete
🧹 Applying retention policy (keep within 7 days)...
✅ Backup complete.
```

### Ce qui se passe à la première exécution

1. Un mot de passe de chiffrement aléatoire est généré et enregistré dans `~/.slv/restic-password` (mode 0600)
2. Un dépôt restic est initialisé sur ERPC Cloud Storage
3. L'intégralité de votre disque est sauvegardée (hors pseudo-systèmes de fichiers du système)

### Exécutions suivantes

Seuls les fichiers modifiés sont envoyés (sauvegarde incrémentale). La déduplication permet de limiter les coûts de stockage.

## Lister les sauvegardes

```bash
sudo slv backup list
```

Affiche à la fois les snapshots restic et les sauvegardes tar du mode hérité présentes dans le stockage cloud.

## Restaurer depuis une sauvegarde

Restaurer le dernier snapshot :

```bash
sudo slv backup restore latest
```

Restaurer un snapshot précis :

```bash
sudo slv backup restore b6925e6d
```

Restaurer une sauvegarde tar du mode hérité :

```bash
sudo slv backup restore backup-mynode-20260318.tar.zst
```

## Vérifier l'intégrité des sauvegardes

Pour exécuter `restic check` vous-même, connectez-vous avec une clé d'accès au stockage. Les clés d'API RPC ne sont pas acceptées sur cet endpoint.

1. Ouvrez la [page Storage](https://dashboard.erpc.global/fr/user/storage), allez dans **Clés d'accès au stockage**, puis cliquez sur **Émettre une clé**. **Lecture seule** suffit pour `check`.
2. Copiez l'**URL du dépôt restic** affichée juste après la création de la clé. Elle n'est affichée qu'une seule fois : si vous la perdez, révoquez la clé et émettez-en une nouvelle.
3. Exécutez `check` avec cette URL :

```bash
sudo restic -r '<RESTIC_REPOSITORY_URL>' \
  --password-file ~/.slv/restic-password check
```

## Configurer des sauvegardes automatiques (Cron)

```bash
sudo slv backup create --restic --cron daily
```

| Intervalle | Description |
|---|---|
| `daily` | Exécution une fois par jour |
| `weekly` | Exécution une fois par semaine |
| `monthly` | Exécution une fois par mois |
| `off` | Supprime la tâche cron |

### Rétention

Par défaut, les snapshots de plus de 7 jours sont supprimés automatiquement :

```bash
sudo slv backup create --restic --retention 14
```

## Personnaliser les exclusions

Afficher la liste d'exclusions actuelle :

```bash
slv backup create --list-excludes
```

Ajouter des chemins à exclure :

```bash
sudo slv backup create --restic --exclude /home/solv/ledger --exclude /home/solv/snapshots
```

## Chiffrement et sécurité

| Fonctionnalité | Détail |
|---|---|
| **Chiffrement** | AES-256-CTR + Poly1305-AES (côté client) |
| **Intégrité** | Stockage adressé par le contenu (SHA-256) |
| **Déduplication** | Découpage en blocs défini par le contenu |
| **Visibilité côté serveur** | Aucune — le serveur ne voit que des blobs chiffrés |
| **Fichier de mot de passe** | `~/.slv/restic-password` (mode 0600) |
| **Exclus de la sauvegarde** | `~/.slv/restic-password`, `~/.slv/api.yml`, `~/.slv/backup.env` |

> ⚠️ **IMPORTANT** : sauvegardez séparément votre fichier `~/.slv/restic-password`. Sans lui, vos sauvegardes sont irrémédiablement perdues.

## Référence des options

| Option | Description |
|---|---|
| `--restic` | Utilise restic pour une sauvegarde incrémentale chiffrée (recommandé) |
| `-r, --region <region>` | Région de stockage (par défaut : eu) |
| `--exclude <path>` | Chemins supplémentaires à exclure (répétable) |
| `--include <path>` | Retire un chemin des exclusions par défaut (répétable) |
| `--list-excludes` | Affiche la liste d'exclusions actuelle puis quitte |
| `--retention <days>` | Supprime les snapshots de plus de N jours (par défaut : 7) |
| `--cron <interval>` | Configure une tâche cron (daily/weekly/monthly/off) |
| `-y, --yes` | Ignore les demandes de confirmation |
| `--upload` | Mode hérité : envoie la sauvegarde tar vers le stockage cloud |
| `-o, --output <path>` | Mode hérité : chemin du fichier de sortie de la sauvegarde tar |

## Mode hérité (tar+zstd)

Pour assurer la rétrocompatibilité, les sauvegardes tar non chiffrées restent prises en charge :

```bash
sudo slv backup create --upload --yes     # Unencrypted tar backup
```

> **Remarque** : les sauvegardes du mode hérité ne sont pas chiffrées. Nous recommandons de passer à `--restic` pour toutes les nouvelles sauvegardes.