Como Migrar o WHMCS para Outro Domínio Sem Ficar Offline: Passo a Passo Completo

Para migrar sua instalação do WHMCS de um domínio para outro sem ficar offline, siga os passos abaixo com atenção:

1. Preparação Antes da Migração

✅ Faça backup completo

• Banco de dados (MySQL)
• Arquivos do WHMCS (FTP ou Gerenciador de Arquivos)
• Configurações personalizadas (hooks, templates, módulos, etc.)

✅ Verifique a nova hospedagem

• Se estiver migrando para um novo servidor, certifique-se de que os requisitos do WHMCS estão atendidos.
• Configure um banco de dados novo (ou garanta que tem acesso ao existente).

✅ Desative temporariamente a cron job

• Isso evita que tarefas automáticas rodem durante a migração e causem problemas.

2. Copiar Arquivos e Banco de Dados

✅ Transfira os arquivos do WHMCS

• Copie toda a pasta do WHMCS para o novo domínio.

✅ Exporte e importe o banco de dados

• Use o phpMyAdmin ou mysqldump para exportar o banco de dados do WHMCS.
• No novo servidor, importe o banco de dados.

✅ Atualize o arquivo configuration.php

• No diretório do WHMCS, edite o arquivo configuration.php e atualize as seguintes linhas:
• <?php
  $whmcsUrl = 'https://novo-dominio.com';
$license = 'SUA-NOVA-LICENÇA';
// Se aplicável
• Se o banco de dados mudou, ajuste também as credenciais:
  <?php
  $db_host = 'localhost';
$db_username = 'novo_usuario';
$db_password = 'nova_senha';
$db_name = 'novo_banco';

3. Ajustes no Novo Domínio

✅ Atualize o domínio na Administração do WHMCS

• Acesse tblconfiguration no banco de dados e atualize a URL do WHMCS:
  UPDATE tblconfiguration SET value='https://novo-dominio.com' WHERE setting='SystemURL';
• Se o WHMCS tiver um diretório de administração personalizado, ajuste a configuração no banco.

✅ Verifique permissões de arquivos

• configuration.php deve ter permissão 400 ou 440
• Pastas templates_c, downloads, attachments e crons precisam estar com permissão 755

✅ Registre o novo domínio na WHMCS (Licença)

• Se sua licença do WHMCS for vinculada ao domínio, entre no portal do WHMCS e redefina sua licença para o novo domínio.

✅ Regere os arquivos .htaccess e crons

• Se houver regras personalizadas no .htaccess, ajuste para o novo domínio.

4. Testes Antes da Ativação

✅ Acesse a nova URL e faça testes

• Faça login no admin e verifique se tudo está carregando corretamente.
• Teste geração de faturas, envio de e-mails e integrações com gateways de pagamento.

✅ Reative a Cron Job

• Se estiver tudo certo, ative a cron novamente (crons/cron.php).

✅ Atualize links no site e notificações

• Verifique módulos personalizados, links internos e notificações que possam estar apontando para o domínio antigo.

5. (Opcional) Configurar Redirecionamento

Se o domínio antigo ainda estiver ativo, faça um redirecionamento 301 no .htaccess:

apacheCopiarEditarRewriteEngine On
RewriteCond %{HTTP_HOST} ^antigo-dominio.com [NC]
RewriteRule ^(.*)$ https://novo-dominio.com/$1 [L,R=301]

Pronto! WHMCS migrado com sucesso 🚀