Pular para o conteúdo
Documentação

Migrar sites do CWP, cPanel ou outro servidor

Como trazer contas, domínios, arquivos e bancos MySQL de um servidor CWP, cPanel ou qualquer servidor com SSH para o miniCP.

R Regis Manze 20/11/2026 6 min de leitura

A tela Migracao de sites traz sites de outro servidor para o miniCP por SSH. Ela cria as contas e os domínios, copia os arquivos e, se você quiser, os bancos MySQL. Cada migração vira uma tarefa que pode ser repetida para a sincronização final antes de trocar o DNS.

Acesse pelo menu Hospedagem > Migracao.

Tipos de origem

Origem O que o painel faz
CWP Descobre as contas, cria usuários e domínios (mapeando a versão do PHP), copia as homes e, opcionalmente, os bancos.
cPanel Igual ao CWP, lendo as contas do cPanel.
Generico (SSH) Você navega no servidor remoto, escolhe um diretório e importa para um usuário do painel.

Antes de começar

  • Acesso SSH à origem como root (ou usuário com acesso de leitura às homes e ao MySQL).
  • Para migrar bancos, o MySQL/MariaDB precisa estar instalado no miniCP.
  • As versões de PHP usadas pelos sites devem estar instaladas no miniCP. Se a versão exata não existir, o painel usa a mais nova instalada e marca o domínio com *default no log.

Atenção: a senha SSH nunca é guardada. Você digita de novo a cada operação.

Conectar na origem

No quadro Conexao com a origem:

Campo O que informar
Origem CWP, cPanel ou Generico (SSH).
Host Nome ou endereço do servidor de origem.
Porta SSH Padrão 22.
Usuario SSH Normalmente root.
Senha SSH Senha do usuário SSH (não é salva).
API do CWP e Chave da API Opcionais, só para CWP. Ajudam a listar as contas.

Clique em Salvar conexao para guardar host, porta e usuário para a próxima vez.

Migrar contas do CWP ou cPanel

  1. Preencha a conexão e a senha SSH.
  2. Clique em Descobrir contas. O painel lista as contas da origem com tamanho, bancos e domínios (com a versão do PHP).
  3. Marque as contas que quer trazer, ou use Selecionar todas.
  4. Revise os bancos de cada conta clicando no botão de bancos da linha. Os bancos com nome usuario ou usuario_* já vêm marcados. Inclua qualquer outro banco que o site use.
  5. Deixe Migrar bancos marcado se quiser trazer os bancos.
  6. Clique em Migrar selecionadas.

O progresso aparece em tempo real na tela. Para cada conta, o painel:

  1. cria o usuário no miniCP com uma senha aleatória (guardada em arquivo, veja abaixo);
  2. cria os domínios e aliases, com pool PHP e vhost;
  3. copia a home inteira por rsync e ajusta o dono dos arquivos;
  4. importa os bancos marcados e recria os usuários MySQL com a mesma senha, para o site conectar sem mudar a configuração;
  5. recarrega o servidor web;
  6. salva uma tarefa de migração.

Cópia dos arquivos

A cópia não traz arquivos de dispositivo, FIFOs nem os bits setuid/setgid. Tudo chega ao miniCP e, em seguida, recebe o dono da conta de destino.

Domínios, aliases e document root

O document root e os aliases vindos da origem passam pela mesma validação da tela Dominios:

  • um alias inválido, ou que já pertença a outro site do miniCP, é ignorado, com aviso no log;
  • um document root inválido (com espaços, .. ou caracteres fora de letras, números, ., _, - e /) vira public_html, com aviso no log.

Bancos de dados

  • Um banco que já existe no miniCP e pertence a outra conta não é sobrescrito: a migração pula esse banco e avisa no log.
  • Usuários MySQL que já existem no miniCP não são alterados (nem a senha, nem as permissões).
  • Das permissões da origem, só entram as do próprio banco migrado. Permissões em *.* ou em outro banco são ignoradas, com o aviso "permissao(oes) fora do banco ... ignorada(s)".
  • Se a importação de um banco falhar no meio, a tarefa fica marcada com erro.
  • Os bancos migrados entram no registro do painel com a conta como dona. Assim, passam a entrar no backup agendado da conta, mesmo com nome fora do padrão usuario_*.

Senha dos usuários criados

A senha gerada para cada usuário novo não aparece no log da migração. O log só indica onde ela foi guardada. As senhas ficam no arquivo /root/minicp-senhas-migracao.txt, que só o root lê, com uma linha por usuário criado: data, usuário e senha.

Para consultar, acesse o servidor por SSH como root:

cat /root/minicp-senhas-migracao.txt

Dica: troque a senha de cada usuário migrado em Usuarios e informe a nova ao cliente. Depois, apague as linhas que não precisa mais desse arquivo.

Se o usuário ou o domínio já existir no miniCP, ele é mantido e o passo é pulado.

O que não vem na migração

  • E-mails (a pasta mail é ignorada).
  • Pastas tmp, logs, .cache, lixeira e arquivos internos do cPanel/CWP.
  • Certificados SSL: emita de novo no miniCP depois de apontar o DNS.
  • Crons e configurações de DNS.

Importar um diretório (Generico)

  1. Escolha Generico (SSH) em Origem e preencha a conexão.
  2. Clique em Conectar e navegar.
  3. Navegue pelas pastas no quadro Diretorio remoto e clique em usar no diretório desejado.
  4. Em Importar para o usuario, escolha um usuário existente ou digite um novo. Um usuário novo é criado com senha aleatória, guardada no mesmo arquivo /root/minicp-senhas-migracao.txt.
  5. Ajuste a Pasta de destino (dentro da home). O padrão é public_html.
  6. Opcional: informe um domínio em Criar dominio e escolha o PHP.
  7. Clique em Importar e confirme.

No modo genérico não há migração de bancos. Exporte e importe os bancos à parte.

Sincronização final (tarefas)

Toda migração aparece em Tarefas de migracao, com origem, destino, última execução e número de execuções. Use isso para trazer o que mudou na origem antes de trocar o DNS.

  1. Na tarefa, clique em Repetir.
  2. Digite a Senha SSH da origem.
  3. Escolha as opções:
    • Espelhar exclusoes (--delete): apaga no destino o que não existe mais na origem.
    • Reimportar os bancos: importa de novo os bancos da tarefa, sobrescrevendo os dados do destino.
  4. Clique em Sincronizar.

Roteiro recomendado para a virada:

  1. Faça a migração inicial com o site ainda no ar na origem.
  2. Teste o site no miniCP (por exemplo, pelo arquivo hosts do seu computador).
  3. Coloque o site em manutenção na origem.
  4. Rode Repetir com Reimportar os bancos marcado.
  5. Aponte o DNS para o miniCP e emita o SSL.

Atenção: "Reimportar os bancos" sobrescreve tudo o que foi gravado no banco do miniCP desde a migração. Não use depois que o site já estiver recebendo pedidos no servidor novo.

Copiar para usar com IA

Este artigo foi útil?

Que bom! O que ajudou mais? O que faltou nesta página?

Opcional — seu voto já foi registrado.

Obrigado pelo seu feedback!