# Démarrage rapide

Objectif : votre serveur est sauvegardé automatiquement, et vous avez vérifié qu’une restauration fonctionne. Comptez cinq minutes.

## Prérequis

- Un serveur **Linux** en **amd64** (x86_64) ou **arm64** (aarch64) : Debian, Ubuntu, RHEL, Rocky, AlmaLinux, Fedora, Alpine… Noyau Linux 3.2 ou plus récent, pas de 32 bits. Avec systemd, ou cron avec son démon lancé (Alpine : `rc-update add crond default && rc-service crond start`). Famille RHEL : `sudo` ne cherche pas dans `/usr/local/bin`, tapez `sudo /usr/local/bin/neverwiped …`.
- Un accès **root** (ou `sudo`).
- `curl` ou `wget`, et `sha256sum` ou `openssl` (présents sur presque toutes les distributions).
- Des connexions sortantes HTTPS (port 443) vers :
  - `https://neverwiped.com` : la plateforme (enregistrement, état, téléchargement de l’agent) ;
  - `https://storage.neverwiped.com` : le stockage des sauvegardes ;
  - `https://github.com` (et `objects.githubusercontent.com`) : téléchargement de restic à l’installation, une seule fois, empreinte SHA-256 vérifiée.

## 1. Créer un compte et une clé d’API

1. Inscrivez-vous sur https://neverwiped.com/inscription (essai gratuit de 14 jours, sans carte).
2. Cliquez sur le lien reçu par e-mail pour confirmer votre adresse. **Sans cette confirmation, la clé d’API est refusée.**
3. Dans votre espace client, ouvrez **Clés d’API** (https://neverwiped.com/espace/cles-api), donnez un nom à la clé (par exemple « VPS production ») et cliquez sur **Créer la clé**.
4. Copiez la clé : elle commence par `nw_acc_` et n’est affichée qu’une fois.

Une même clé de compte peut enregistrer plusieurs serveurs (dans la limite de votre formule). Après l’installation, le serveur utilise sa propre clé d’agent : vous pouvez révoquer la clé de compte sans interrompre les sauvegardes.

## 2. Installer en une commande

Sur le serveur, en root :

```sh
curl -fsSL https://neverwiped.com/install.sh | sh -s -- --api-key nw_acc_VOTRE_CLE --yes
```

Sans `curl` :

```sh
wget -qO- https://neverwiped.com/install.sh | sh -s -- --api-key nw_acc_VOTRE_CLE --yes
```

Si vous n’êtes pas root, remplacez `| sh` par `| sudo sh`.

Vous préférez répondre aux questions vous-même ? Lancez simplement `curl -fsSL https://neverwiped.com/install.sh | sh` : le script demande la clé, affiche le plan de sauvegarde et attend votre confirmation.

Le script :

1. télécharge l’agent pour votre architecture, **vérifie son empreinte SHA-256** et l’installe dans `/usr/local/bin/neverwiped` ;
2. lance `neverwiped install`, qui télécharge restic 0.18.1 (empreinte vérifiée), détecte ce qu’il faut sauvegarder et affiche le plan ;
3. enregistre le serveur sur votre compte, crée le dépôt chiffré et la **clé de récupération** ;
4. planifie les sauvegardes selon votre formule et lance la première.

## 3. Noter la clé de récupération

À la fin de l’installation, l’agent affiche un encadré :

```text
========================================================================
CLÉ DE RÉCUPÉRATION — notez-la maintenant, hors de ce serveur.

    Ab3dEf-GhJkMn-PqRsTu-VwXyZa-b2c3d4-e5f6g7

Elle ne sera plus jamais affichée et NeverWiped ne la connaît pas.
Sans elle, si ce serveur est perdu, vos sauvegardes sont illisibles.
========================================================================
```

**Copiez-la dans un gestionnaire de mots de passe, hors du serveur.** Tant que le serveur existe, l’agent a sa propre clé (`/etc/neverwiped/repo.key`) et n’en a pas besoin. Si le serveur est perdu, c’est la seule façon de relire vos sauvegardes : nous ne la connaissons pas et ne pouvons pas la retrouver.

## 4. Vérifier

```sh
neverwiped status
```

Sortie attendue (exemple, en français : l’agent suit la langue du système, anglais par défaut, et `NEVERWIPED_LANG=fr`, `en` ou `es` la force) :

```text
Serveur      : vps-prod (identifiant be1e7955-1dd6-4211-8002-7746d6ede9e2)
Plateforme   : https://neverwiped.com
Agent        : neverwiped 0.3.0, restic 0.18.1
Dossiers     : /etc, /var/spool/cron, /var/www
Base         : postgresql (locale)
Abonnement   : Essentiel (trialing)
Sauvegardes  : hebdomadaire, actives
Espace       : 3,3 Mo utilisés sur 5,0 Go
Dernière     : 2026-11-03 22:59
Planification: crontab de root (crond)
```

Points à contrôler : « Sauvegardes : …, actives », une ligne « Dernière » avec la date du jour, et une ligne « Planification » (minuteur systemd, `/etc/cron.d/neverwiped` ou crontab de root).

```sh
neverwiped list
```

```text
DATE               ID            AJOUTÉ  CONTENU
2026-11-03 22:59   8b28999a      3,3 Mo  /etc /var/lib/neverwiped/dumps /var/spool/cron /var/www

Restaurer : neverwiped restore <DATE ou ID> [--target DOSSIER]
```

Le tableau de bord de votre espace client (https://neverwiped.com/espace) affiche le même serveur, la date de la dernière sauvegarde et l’espace utilisé.

## 5. Tester une restauration (recommandé)

Une sauvegarde n’a de valeur que si elle se restaure. Faites-le une première fois maintenant, dans un dossier à part, sans rien écraser :

```sh
neverwiped restore latest --target /root/restauration-test --yes
ls /root/restauration-test
rm -rf /root/restauration-test
```

Les fichiers sont remis sous leur chemin d’origine : `/var/www` se retrouve dans `/root/restauration-test/var/www`. Voir [Restaurer](https://docs.neverwiped.com/restauration) pour le reste.

## Et ensuite ?

- Les sauvegardes tournent seules, la nuit (entre 1 h et 6 h environ, heure du serveur). Vous recevez un e-mail en cas d’échec, ou si aucune sauvegarde n’a réussi depuis plusieurs jours.
- Pour ajouter un dossier ou exclure des fichiers : relancez `neverwiped install --include /chemin --exclude "motif" --yes`. Le plan est recalculé à chaque fois : répétez toutes vos options (voir [Référence des commandes](https://docs.neverwiped.com/commandes)).
- Pour passer en sauvegarde quotidienne : changez de formule dans l’espace client ; l’agent adapte sa planification à la sauvegarde suivante.