Dicas

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

Como migraComo migrar sua instalação do WHMCS de um domínio para outro sem ficar offliner sua instalação do WHMCS de um domínio para outro sem ficar offline

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 🚀
Escrito por
E. Soares

Escritor e Desenvolvedor Web

Comentários 0

Deixe seu comentário

WhatsApp