Como migrar uma aplicação Docker de um VPS para outro sem perder dados

Migrando sua aplicação Docker de um VPS para outro sem perder nada 🐳

Oi! Aqui é a Sensei da GeHost 😊 Se você chegou até esse guia, provavelmente está de olho num VPS novo — seja pra ganhar mais recursos, seja pra reorganizar sua infraestrutura — e bateu aquele friozinho na barriga: "e se eu perder meus dados no meio do caminho?". Respira. Migrar uma aplicação Docker entre servidores é bem mais tranquilo do que parece, desde que você siga uma ordem certinha. Vamos passo a passo, com calma, do jeitinho que eu explicaria pra alguém do meu time.

Regra de ouro: nunca desligue o servidor antigo antes de confirmar, de verdade, que tudo está rodando igualzinho no novo. Migração não é corrida — é primeiro confirmar, depois desligar.

Antes de começar: o que você precisa ter em mãos

• Acesso (SSH) aos dois servidores — o antigo e o novo.
• Docker e Docker Compose instalados no servidor novo (se ainda não estiver, seu contrato/painel de suporte pode te orientar sobre isso).
• Uma cópia do(s) arquivo(s) docker-compose.yml e das configurações da sua aplicação.
• Um horário de baixo movimento pra fazer a virada — evita transtorno pros seus usuários.

Passo a passo da migração

1. Mapeie tudo o que sua aplicação usa

Antes de mexer em qualquer coisa, faça uma lista do que compõe sua aplicação: quais containers rodam, quais volumes guardam dados (banco de dados, uploads, imagens etc.), quais variáveis de ambiente e redes são usadas. É basicamente o "raio-x" da sua aplicação — sem ele, é fácil esquecer uma peça pelo caminho.

2. Pare a aplicação com segurança (ou ao menos o banco de dados)

Pra garantir que os dados não fiquem "no meio da gravação" durante a cópia, o ideal é parar a aplicação (ou pelo menos o container do banco de dados) por alguns minutinhos antes de copiar os volumes. Assim você evita pegar um arquivo corrompido ou pela metade.

3. Faça o backup dos volumes (onde moram seus dados de verdade)

Os containers em si são só a "casca" — o que realmente importa são os volumes. Gere um backup deles, por exemplo compactando as pastas de dados em um arquivo .tar.gz. Esse arquivo compactado é o que você vai transportar pro novo servidor.

💡 Dica da Sensei: nomeie o backup com a data (ex.: backup-app-2026-07-22.tar.gz). Parece bobo, mas evita muita dor de cabeça quando você tem mais de uma cópia rodando por aí.

4. Transfira os arquivos pro servidor novo

Com o backup pronto, copie-o do servidor antigo pro novo. Pode ser via scp, rsync ou até um serviço de armazenamento intermediário — o importante é garantir que o arquivo chegue inteiro. Depois de copiar, é sempre bom conferir o tamanho do arquivo nos dois lados pra ter certeza de que nada foi cortado no meio do caminho.

5. Suba a estrutura no servidor novo

1. Copie também o seu docker-compose.yml e os arquivos de configuração/variáveis de ambiente pro servidor novo.
2. Restaure o backup dos volumes nos diretórios correspondentes.
3. Suba os containers com o Docker Compose.
4. Verifique se todos os containers subiram e se os dados estão lá (acesse a aplicação, confira registros no banco, veja se os arquivos/uploads aparecem certinho).

6. Aponte o domínio pro servidor novo (só depois de tudo validado!)

Só depois que você testar e confirmar que a aplicação está 100% funcional no servidor novo é que você deve atualizar o apontamento do seu domínio (registro DNS) pra ele. Isso evita que seus visitantes caiam numa versão incompleta ou fora do ar. Se seu domínio estiver hospedado com a GeHost, a gestão da zona de DNS fica disponível no cPanel, na tela de edição de zona.

⏳ Lembre-se: alterações de DNS não são instantâneas em todo mundo — pode levar um tempinho até todos os visitantes passarem a acessar o servidor novo. Por isso, só desligue o servidor antigo depois de um período de segurança.

7. Só depois de tudo confirmado: desligue o servidor antigo

Depois que o novo servidor estiver estável, o DNS propagado e você já tiver testado por um tempo (uns dias, se der), aí sim é seguro desativar o servidor antigo. Antes disso, mantenha-o de pé — ele é sua rede de segurança caso algo precise ser conferido de última hora.

Checklist rápido pra não esquecer nada

• ✅ Mapeei containers, volumes e variáveis de ambiente
• ✅ Parei a aplicação/banco antes do backup
• ✅ Fiz backup dos volumes e conferi o tamanho do arquivo
• ✅ Transferi tudo pro servidor novo
• ✅ Subi os containers e testei a aplicação de ponta a ponta
• ✅ Só então atualizei o DNS
• ✅ Aguardei a propagação antes de desligar o servidor antigo

Precisa de uma mãozinha?

Se em algum momento você sentir que travou ou não tem certeza de algum passo, não force a barra — fala com a nossa equipe pelo painel.gehost.com.br. A gente prefere te ajudar antes de algo dar errado do que remendar depois 💙. E lembra: todo serviço entregue pela GeHost já vem com suporte gratuito por 30 dias após a entrega, então aproveita essa janela pra tirar qualquer dúvida.

Bora migrar com tranquilidade? Você consegue! 🚀