---
title: "SLV Migrate Linux - Démarrage rapide"
description: "Migrez l'intégralité de votre serveur Linux vers une nouvelle machine avec slv migrate linux."
canonical: "https://erpc.global/fr/doc/migrate/quickstart/"
locale: "fr"
---

# SLV Migrate Linux - Démarrage rapide

## 🚚 SLV Migrate Linux

Migrez l'intégralité de votre disque Linux vers un nouveau serveur via SSH avec rsync. Il s'agit d'une migration du disque complet — tout le contenu du serveur source est copié vers la destination, y compris les données utilisateur, les configurations, les paquets installés et la configuration du nœud SLV.

> **Remarque :** cette commande est différente de `slv v switch` (migration de l'identité du validateur). `slv migrate linux` copie l'ensemble du système de fichiers, tandis que `slv v switch` échange l'identité du validateur entre deux nœuds déjà en fonctionnement.

### Prérequis

- SLV CLI installé sur le nœud **source**
- Accès `sudo` / root sur la source et la destination
- Accès SSH de la source vers la destination (par mot de passe ou par clé)
- Le serveur de destination devrait être une installation neuve (SLV affiche un avertissement s'il détecte des données existantes)

## Utilisation de base

Exécutez sur le serveur **source** :

```bash
sudo slv migrate linux --to root@new-server-ip
```

```
🚚 SLV Linux Migration

  Source:      ubuntu (this machine)
  Destination: root@203.0.113.50

📋 Exclude list:
  • /dev/*
  • /proc/*
  • /sys/*
  • /tmp/*
  • /run/*
  • /mnt/*
  • /media/*
  • /lost+found
  • /swapfile
  • /snap/*
  • /var/log/*

? Start migration? This will overwrite data on the destination. › Yes
  Syncing... (this may take a while depending on disk size)
√ Migration complete
  Rebooting destination...
```

## Options

| Option | Description |
|---|---|
| `-t, --to <ssh>` | Destination SSH (par ex. `root@new-server`) |
| `-p, --port <port>` | Port SSH (par défaut : 22) |
| `--skip-reboot` | Ne redémarre pas automatiquement après la migration |
| `--exclude <path>` | Motif d'exclusion rsync supplémentaire (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 |
| `-y, --yes` | Ignore la demande de confirmation |

## Port SSH personnalisé

Si la destination utilise un port SSH non standard :

```bash
sudo slv migrate linux --to root@new-server-ip --port 2222
```

## Personnaliser les exclusions

Affichez ce qui sera exclu :

```bash
slv migrate linux --list-excludes
```

Excluez des chemins supplémentaires (par ex. ignorez les données du ledger pour accélérer la migration) :

```bash
sudo slv migrate linux --to root@new-server-ip --exclude /home/solv/ledger
```

## Mode non interactif

Pour les scripts :

```bash
sudo slv migrate linux --to root@new-server-ip --skip-reboot --yes
```

## Fonctionnement

1. **Vérifications préalables** — vérifie la connectivité SSH et avertit si la destination contient des données existantes
2. **rsync** — copie l'intégralité du système de fichiers (hors pseudo-systèmes de fichiers du système) via SSH
3. **Après la migration** — redémarre automatiquement le serveur de destination (sauf avec `--skip-reboot`)

La migration utilise rsync avec `--archive --hard-links --acls --xattrs` pour préserver tous les attributs de fichiers, les permissions et les fichiers spéciaux.

## ⚠️ Remarques importantes

- **Exécutez en tant que root** (ou avec `sudo`). Une migration sans les droits root omettra des fichiers système.
- La destination devrait être un **serveur neuf**. Les données existantes seront écrasées.
- Les codes de sortie rsync 23/24 (transfert partiel) sont traités comme des avertissements, et non comme des erreurs. Certains fichiers (comme les logs actifs) peuvent ne pas être transférés parfaitement.
- Après la migration, vérifiez que le nœud fonctionne correctement avant de mettre la source hors service.
- Pour la **migration de l'identité du validateur** (bascule sans interruption entre deux validateurs en fonctionnement), utilisez plutôt `slv v switch`. Consultez [Migration de validateur Mainnet](https://erpc.global/fr/doc/mainnet-validator/migrate/).