← Voltar para a Central de Ajuda

Como instalar e hospedar o WHMCS no seu próprio servidor

Atualizado recentemente • Engenharia Altiva Hub

Para garantir isolamento, segurança e alta disponibilidade do seu sistema financeiro, a melhor prática é criar um **Spot (Conta cPanel)** exclusivo para hospedar o WHMCS da sua agência (ex: central.suaagencia.com.br ou financeiro.suaagencia.com.br).

Passo 1: Criar o Spot Dedicado no WHM

  1. Acesse o seu painel WHM Master.
  2. No menu lateral, vá em Account Functions > Create a New Account.
  3. Em Domain Information, insira o subdomínio escolhido (Ex: central.suaagencia.com.br).
  4. Defina a senha e selecione o pacote de recursos do seu plano.
  5. Clique em Create para gerar a conta isolada.
  6. Acesse o cPanel dessa nova conta e garanta que o certificado SSL (AutoSSL) esteja ativo.

Método A: Instalação Automática via Softaculous (Mais Recomendado)

O jeito mais rápido e prático de instalar o WHMCS com todas as dependências pré-configuradas:

  1. Acesse o cPanel da sua conta central.suaagencia.com.br.
  2. Na seção Software, clique em Softaculous Apps Installer.
  3. No campo de busca do Softaculous, digite WHMCS e selecione o aplicativo.
  4. Clique no botão Install Now e preencha as configurações:
    • Software Setup: Selecione o protocolo https:// e o subdomínio correto. Deixe o campo In Directory em branco.
    • License Key: Cole a chave de licença enviada no seu ticket pela Altiva Hub.
    • Admin Account: Cadastre o usuário, senha e e-mail do administrador principal do sistema.
  5. Clique em Install no final da página. O Softaculous criará a estrutura de arquivos e o banco de dados em instantes.

Método B: Instalação Manual via Gerenciador de Arquivos

Caso prefira baixar o pacote oficial diretamente do portal da WHMCS:

  1. Acesse o cPanel do Spot da sua central.
  2. Crie um banco de dados MySQL e um usuário com todos os privilégios na ferramenta Bancos de Dados MySQL.
  3. Acesse o Gerenciador de Arquivos (File Manager), entre na pasta public_html e faça o upload do arquivo `.zip` oficial do WHMCS.
  4. Extraia o conteúdo zipado diretamente dentro do diretório `public_html`.
  5. Renomeie o arquivo configuration.php.new para configuration.php.
  6. Acesse a URL https://central.suaagencia.com.br/install/install.php pelo seu navegador e siga o assistente informando a chave de licença e as credenciais do MySQL criadas.
  7. Ao finalizar, volte ao Gerenciador de Arquivos e **apague completamente a pasta /install/** por motivos de segurança.
Configuração de Cron Job (Obrigatório): Para que o WHMCS processe as cobranças diárias, envie faturas e crie contas sozinho, você deve adicionar a tarefa Cron informada ao final da instalação no cPanel (em Tarefas Cron / Cron Jobs) para rodar 1 vez por dia.

Próximo Passo: Conectar o WHMCS ao WHM

Agora que o seu painel está instalado, você precisa integrá-lo com o seu servidor WHM para que a criação automática de contas cPanel passe a funcionar.

Ir para o Guia de Integração WHM