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
- Copie também o seu docker-compose.yml e os arquivos de configuração/variáveis de ambiente pro servidor novo.
- Restaure o backup dos volumes nos diretórios correspondentes.
- Suba os containers com o Docker Compose.
- 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! 🚀