O que é

Migrar um Mautic é muito parecido com migrar um WordPress: você leva o banco de dados e o
conteúdo da pasta htdocs. A diferença está em um arquivo, o config/local.php, que guarda
as credenciais do banco, os caminhos absolutos e uma secret key sem a qual metade das
configurações não volta.

A estratégia é a mesma da migração de site: monta-se tudo
no servidor novo, testa-se pelo arquivo hosts e o DNS só vira no fim. O site antigo fica no ar o
tempo todo.

O que você precisa do servidor antigo

Duas coisas, e nada mais:

• O banco de dados exportado em .sql.
• Todo o conteúdo da pasta pública (htdocs): app, bin, config, plugins, media, patches
  e o que mais existir ali.

Exportando o banco do servidor antigo

Se o Mautic de origem já está em um GW Server, é a aba Banco de dados → Exportar SQL, e o
download começa (ver Banco de dados do site).

Em outra hospedagem, use o que ela oferecer: SSH com mysqldump, um gerenciador como o Adminer,
ou a exportação do painel (o CloudPanel tem; no WordOps o caminho costuma ser SSH).

O local.php: o arquivo que decide a migração

Em htdocs/config/local.php fica o equivalente ao wp-config.php do WordPress. Três blocos
importam:

• Credenciais do banco: db_name, db_user, db_password.
• A secret key: ela descriptografa dados gravados no banco, como as credenciais de
  autenticação SMTP. Sem a secret key original, boa parte da configuração não volta mesmo com o
  banco certo.
• Caminhos absolutos: o caminho da pasta pública aparece repetido no arquivo (na instalação de
  exemplo, 11 vezes), e a URL do Mautic aparece cerca de 12.

Compactando a pasta pública

Pelo gerenciador de arquivos, selecione tudo dentro da htdocs e gere um .zip. Por SSH, um
zip -r backup.zip . dentro da pasta resolve e costuma ser mais rápido em instalação grande.

Instalando um Mautic limpo no servidor novo

No GW Server, instale um Mautic novo em Sites com três cuidados (ver
Instalando o Mautic):

1. Mesmo domínio do Mautic atual.
2. Mesma versão do Mautic de origem: o instalador aceita a versão específica, e é o que
   garante compatibilidade na hora de importar o banco.
3. Perfil de cron conforme o tamanho da lista: Lite para instalações menores, Performance
   para listas grandes e muitas campanhas.

Usuário e senha de administrador podem ser quaisquer: o banco importado vai sobrescrevê-los. Se
puder, repita os mesmos, para não se confundir depois.

Testando pelo arquivo hosts

Com o Mautic novo instalado no mesmo domínio, aponte o seu computador para o servidor novo pelo
arquivo hosts — o mesmo truque da
migração de site: o IP do servidor novo, um espaço e o
domínio, em C:\Windows\System32\drivers\etc\hosts.

A partir daí o seu navegador vê o servidor novo e o resto do mundo continua vendo o antigo.

Importando o banco de dados

Na aba Banco de dados do site novo, escolha o arquivo .sql e importe.

Depois de importar, o Mautic vai pedir login de novo — agora com o usuário do servidor antigo.
Os contatos aparecem, mas as configurações de e-mail e de DNS vêm vazias. Isso é esperado:
elas não moram no banco, moram nos arquivos. É o que o próximo passo resolve.

Substituindo os arquivos

Na htdocs do site novo, apague tudo e suba o zip do servidor antigo no lugar. Descompacte.

Nesse ponto o site responde com erro. É normal: os arquivos antigos ainda apontam para o banco e
para os caminhos do servidor velho.

Ajustando o local.php

Abra htdocs/config/local.php (agora o arquivo antigo, que veio no zip) e troque apenas:

• db_name, db_user e db_password pelos dados do servidor novo, que estão na aba
  Banco de dados do site.

Não toque na secret key. É ela que vai revelar os dados criptografados que vieram no banco.

Corrigindo os caminhos absolutos

Ainda no local.php, troque todas as ocorrências do caminho da pasta pública antiga pelo caminho
do GW Server:

/var/www/<seu-dominio>/htdocs

Quantas ocorrências existem depende da instalação — no exemplo da aula, 11. Use a busca do editor
para não deixar nenhuma para trás.

O caminho de origem varia conforme a plataforma:

Limpando o cache do Mautic

Passo obrigatório, e o que mais gera “migrei tudo e continua com erro”: apague as pastas dentro de
var/cache (as pastas prod e run).

O Mautic guarda no cache os caminhos e as configurações compiladas da instalação anterior.
Enquanto elas existirem, ele ignora o que você acabou de ajustar. Com o cache limpo, ele volta a
responder e você faz login com os dados do Mautic original.

Virando o DNS

Com tudo validado pelo arquivo hosts, é só apontar o domínio para o servidor novo: na Cloudflare,
abra os registros de DNS e troque o IP do registro do Mautic para o IP do servidor novo (ele está
no dashboard do painel).

Feito isso, a instalação nova passa a atender todo mundo. Lembre de desfazer a linha que você
adicionou no arquivo hosts do seu computador.

Problemas comuns

Veja também

• Instalando o Mautic
• Migrando um site para o GW Server
• Banco de dados do site

---

Em vídeo: Aula 24 · Migração do Mautic a partir de 00:00