---
title: "SLV Migrate Linux - Início rápido"
description: "Migre todo o seu servidor Linux para uma nova máquina com slv migrate linux."
canonical: "https://erpc.global/pt/doc/migrate/quickstart/"
locale: "pt"
---

# SLV Migrate Linux - Início rápido

## 🚚 SLV Migrate Linux

Migre todo o disco Linux para um novo servidor via SSH usando o rsync. É uma migração do disco inteiro — tudo o que está no servidor de origem é copiado para o destino, incluindo dados de usuário, configurações, pacotes instalados e a configuração do nó SLV.

> **Nota:** Isto é diferente de `slv v switch` (migração da identidade do validador). `slv migrate linux` copia todo o sistema de arquivos, enquanto `slv v switch` troca a identidade do validador entre dois nós que já estão em execução.

### Pré-requisitos

- SLV CLI instalado no nó de **origem**
- Acesso `sudo` / root na origem e no destino
- Acesso SSH da origem ao destino (por senha ou por chave)
- O servidor de destino deve ser uma instalação nova (o SLV avisa se detectar dados existentes)

## Uso básico

Execute no servidor de **origem**:

```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...
```

## Opções

| Opção | Descrição |
|---|---|
| `-t, --to <ssh>` | Destino SSH (ex.: `root@new-server`) |
| `-p, --port <port>` | Porta SSH (padrão: 22) |
| `--skip-reboot` | Pula a reinicialização automática após a migração |
| `--exclude <path>` | Padrão de exclusão adicional do rsync (pode ser repetido) |
| `--include <path>` | Remove das exclusões padrão (pode ser repetido) |
| `--list-excludes` | Mostra a lista de exclusões atual e sai |
| `-y, --yes` | Pula a solicitação de confirmação |

## Porta SSH personalizada

Se o destino usar uma porta SSH diferente da padrão:

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

## Personalizar as exclusões

Veja o que será excluído:

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

Exclua outros caminhos (por exemplo, pule os dados do ledger para migrar mais rápido):

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

## Modo não interativo

Para scripts:

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

## Como funciona

1. **Verificações prévias** — Verifica a conectividade SSH e avisa se o destino já tem dados
2. **rsync** — Copia todo o sistema de arquivos (exceto os pseudo-sistemas de arquivos do sistema) via SSH
3. **Pós-migração** — Reinicia automaticamente o servidor de destino (a menos que você use `--skip-reboot`)

A migração usa o rsync com `--archive --hard-links --acls --xattrs` para preservar todos os atributos de arquivo, as permissões e os arquivos especiais.

## ⚠️ Observações importantes

- **Execute como root** (ou com `sudo`). Uma migração sem root deixa arquivos do sistema de fora.
- O destino deve ser um **servidor novo**. Os dados existentes serão sobrescritos.
- Os códigos de saída 23/24 do rsync (transferência parcial) são tratados como avisos, não como erros. Alguns arquivos (como logs ativos) podem não ser transferidos perfeitamente.
- Após a migração, confirme que o nó está funcionando corretamente antes de desativar a origem.
- Para a **migração da identidade do validador** (troca sem downtime entre dois validadores em execução), use `slv v switch` em vez disso. Veja [Migração do validador Mainnet](https://erpc.global/pt/doc/mainnet-validator/migrate/).