---
url: https://docs.snapotter.com/fr/guide/upgrading.md
---

# Mise à niveau de la 1.x vers la 2.0

SnapOtter 1.x stockait tout dans un seul fichier SQLite et s'exécutait dans un seul conteneur. SnapOtter 2.0 utilise PostgreSQL et Redis. Ce guide vous accompagne pour migrer une installation 1.x vers la 2.0 sans perdre de données.

En bref : réutilisez votre volume `/data` existant, et la 2.0 importe automatiquement votre base de données 1.x au premier démarrage. Vos utilisateurs, fichiers enregistrés, paramètres, clés d'API et pipelines sont repris. L'ancienne base n'est jamais modifiée, vous pouvez donc toujours revenir en arrière.

::: tip Un mot pour nos utilisateurs de la 1.x
Beaucoup d'entre vous font confiance à SnapOtter depuis le premier jour, et vos retours ont façonné cette version. La 2.0 change beaucoup de choses en coulisses, et ce guide existe pour que la migration ne vous coûte rien de ce qui compte pour vous. Vos comptes, fichiers, paramètres, clés d'API et pipelines sont repris, et votre ancienne base de données n'est jamais touchée. Merci de migrer avec nous.
:::

## Avant de commencer : sauvegardez tout le volume `/data`

Faites-le en premier, à chaque fois. Sauvegardez le volume `/data` **entier**, pas seulement le fichier `snapotter.db`.

Voici pourquoi c'est important. La 1.x exécute SQLite en mode WAL : un conteneur 1.x arrêté laisse donc couramment l'essentiel de ses données validées dans `snapotter.db-wal`, à côté d'un `snapotter.db` presque vide. Copier uniquement `snapotter.db` capture une base vide et perd silencieusement tout le reste. Le volume contient `snapotter.db`, `snapotter.db-wal`, `snapotter.db-shm` et votre répertoire `files/` ensemble, et ils doivent être transférés comme un tout.

```bash
# Adjust the volume name to match yours (see "Check your volume name" below).
docker run --rm -v SnapOtter-data:/data -v "$PWD":/backup \
  alpine tar czf /backup/snapotter-1x-data.tgz -C /data .
```

## Passez d'abord à la 1.17.2

Mettez à niveau votre installation 1.x vers la dernière version 1.x (1.17.2) avant de passer à la 2.0. Cela permet à la 1.x d'exécuter ses propres migrations de schéma finales, de sorte que la 2.0 importe depuis un schéma connu et complet. Passer directement d'une ancienne version 1.x à la 2.0 n'est pas pris en charge.

## Vérifiez le nom de votre volume

L'importeur ne voit vos données que si la pile 2.0 monte le même volume que celui utilisé par votre installation 1.x. Les noms de volumes Docker sont sensibles à la casse, et d'anciens extraits du README utilisaient `snapotter-data` en minuscules alors que les fichiers Compose utilisent `SnapOtter-data`. Confirmez lequel vous avez :

```bash
docker volume ls | grep -i snapotter
```

Utilisez exactement ce nom dans votre configuration 2.0.

## Voie A : conteneur unique (la plus rapide)

Si vous exécutez SnapOtter avec un seul `docker run`, continuez ainsi. La 2.0 démarre un PostgreSQL et un Redis embarqués dans le conteneur lorsque vous ne définissez pas `DATABASE_URL` ni `REDIS_URL`, et elle détecte et importe automatiquement `/data/snapotter.db` au premier démarrage.

```bash
docker run -d --name snapotter -p 1349:1349 \
  -v SnapOtter-data:/data \
  snapotter/snapotter:latest
```

Surveillez les journaux pour repérer une ligne comme :

```
Imported 1.x SQLite database: {"tables":{"users":2,"teams":1,...},"blobs":{"present":1,"missing":0}}
```

C'est tout. Connectez-vous avec vos identifiants existants.

## Voie B : Compose (recommandée pour la production)

La pile Compose 2.0 exécute trois services (application, Postgres, Redis). Réutilisez votre volume `/data` de la 1.x pour le service de l'application. L'application détecte automatiquement `/data/snapotter.db` et l'importe dans Postgres au premier démarrage.

```yaml
services:
  SnapOtter:
    image: snapotter/snapotter:latest
    volumes:
      - SnapOtter-data:/data          # your existing 1.x volume
      - SnapOtter-workspace:/tmp/workspace
    environment:
      - DATABASE_URL=postgres://${POSTGRES_APP_USER:-snapotter_app}:${POSTGRES_APP_PASSWORD:-snapotter_app}@postgres:5432/${POSTGRES_DB:-snapotter}
      - DATABASE_MIGRATION_URL=postgres://${POSTGRES_USER:-snapotter}:${POSTGRES_PASSWORD:-snapotter}@postgres:5432/${POSTGRES_DB:-snapotter}
      - REDIS_URL=redis://:snapotter@redis:6379
    # ...
```

Si vous préférez pointer explicitement vers l'ancienne base, définissez `SQLITE_MIGRATE_PATH=/data/snapotter.db`. Un chemin explicite l'emporte toujours sur la détection automatique.

## Prévisualiser l'import d'abord (facultatif)

Pour voir exactement ce qui serait importé sans rien écrire, lancez une simulation sur votre fichier de base de données :

```bash
pnpm --filter @snapotter/api migrate:sqlite -- /path/to/snapotter.db --dry-run
```

Elle affiche le nombre de lignes par table, le nombre de fichiers de bibliothèque enregistrés trouvés sur le disque et les statuts de tâche qu'elle va normaliser. Elle n'a pas besoin d'un Postgres en cours d'exécution.

## Ce qui est repris, et ce qui ne l'est pas

Repris :

* Les utilisateurs, et la possibilité de se connecter. Les hachages de mots de passe sont inchangés : le même nom d'utilisateur et le même mot de passe fonctionnent.
* Les équipes, les paramètres (y compris l'identité de votre instance), les rôles, les clés d'API (elles continuent de fonctionner) et les pipelines enregistrés.
* Les enregistrements de l'historique des tâches.
* Votre bibliothèque de fichiers enregistrés, à la fois les enregistrements et les fichiers eux-mêmes, car `/data/files` est conservé sur le volume.

Non repris :

* Les sessions de connexion. Chacun se reconnecte une fois après la mise à niveau. Les identifiants sont inchangés : il s'agit d'une seule reconnexion, rien de plus.
* Les fichiers d'entrée et de sortie des anciennes tâches de traitement. Ils se trouvaient dans un espace de travail temporaire et ont disparu par conception. Les enregistrements de l'historique des tâches subsistent.
* Les indicateurs de consentement aux analyses par utilisateur de la 1.x, qui n'ont pas d'équivalent en 2.0 (les analyses de la 2.0 sont un paramètre au niveau de l'instance).

## Désactiver l'import

Si vous voulez délibérément une base de données neuve alors qu'un `snapotter.db` est présent sur le volume, définissez `SQLITE_MIGRATE_PATH=off`.

## Si vous avez déjà des données dans l'instance 2.0

L'importeur ne s'exécute que vers une base de données vide. Si vous avez démarré la 2.0 à neuf (en créant des données), puis monté plus tard un ancien `snapotter.db`, la 2.0 le détectera mais ne l'importera pas, car la fusion de deux jeux de données peut provoquer des collisions d'identifiants. Vous verrez un avertissement dans les journaux. Pour importer les données de la 1.x, il vous faut une instance vide :

* Si l'instance 2.0 ne contient que l'administrateur par défaut (vous ne l'avez pas vraiment utilisée), arrêtez la pile, supprimez le volume Postgres (`SnapOtter-pgdata`), puis redémarrez avec l'ancien `/data` présent. L'import se fera proprement. Cela n'efface que les données Postgres jetables, pas votre base de données 1.x.
* Si l'instance 2.0 contient de vraies données que vous voulez garder, les deux jeux de données ne peuvent pas être fusionnés automatiquement. Exportez ce dont vous avez besoin et importez les données de la 1.x dans un déploiement neuf distinct.

## Revenir en arrière

La mise à niveau ne modifie ni ne supprime jamais votre `snapotter.db` de la 1.x. Si vous devez revenir à la 1.x, redéployez l'image 1.x sur le même volume. Tout ce que vous avez créé en 2.0 après la mise à niveau se trouve dans Postgres et ne figurerait pas dans la base de données 1.x : revenez donc rapidement en arrière si vous comptez le faire.
