Pular para o conteúdo principal

Instalação

O LeadHub é instalado inteiramente por meio de um assistente baseado em navegador. Sem SSH, sem terminal, sem Composer.

Antes de Começar​

✅ Confirme que seu servidor atende aos requisitos
✅ Crie um banco de dados MySQL e um usuário (anote as credenciais)
✅ Tenha sua chave de licença em mãos (da compra no CodeCanyon)
✅ Tenha acesso FTP/Gerenciador de Arquivos do cPanel para fazer upload dos arquivos

Passo 1 — Fazer Upload dos Arquivos​

  1. Baixe o pacote LeadHub em CodeCanyon → Downloads.
  2. Extraia o arquivo ZIP no seu computador.
  3. Faça upload do conteúdo inteiro da pasta extraída para o diretório raiz do seu site (ex.: public_html/) via FTP ou Gerenciador de Arquivos do cPanel.

⚠️ Não faça upload da pasta externa em si — faça upload do seu conteúdo para que index.php fique diretamente em public_html/.

Passo 2 — Definir Permissões de Arquivo​

Em hospedagem compartilhada, geralmente são definidas automaticamente, mas verifique:

CaminhoPermissão
storage/755 (recursivamente)
bootstrap/cache/755
public/755

Passo 3 — Abrir o Assistente de Instalação​

Navegue até seu domínio no navegador:

https://seudominio.com/install

Se você ver uma página em branco ou erro, verifique se mod_rewrite está habilitado e se .htaccess está presente na raiz.

Passo 4 — Verificação de Requisitos​

O assistente verifica automaticamente todos os requisitos do PHP. Qualquer item com falha é exibido em vermelho com uma breve explicação. Corrija os itens em vermelho antes de prosseguir.

Passo 5 — Configuração do Banco de Dados​

Insira suas credenciais de banco de dados:

CampoDescrição
Host do BancoGeralmente localhost ou 127.0.0.1
Porta do BancoGeralmente 3306
Nome do BancoO banco de dados que você criou
Usuário do BancoO usuário do banco de dados
Senha do BancoA senha do usuário do banco de dados

Clique em Testar Conexão para verificar, depois em Próximo.

Passo 6 — Configurações da Aplicação​

CampoDescrição
URL da AplicaçãoSeu domínio, ex.: https://seudominio.com
Nome da AplicaçãoExibido na aba do navegador e nos e-mails
Fuso HorárioSeu fuso horário principal

Passo 7 — Chave de Licença​

Insira o Código de Compra (chave de licença) da sua compra no CodeCanyon. O assistente valida online.

Passo 8 — Conta do Super Admin​

Crie a primeira conta de super admin:

CampoObservações
NomeSeu nome completo
E-mailUsado para fazer login
SenhaMínimo 8 caracteres

⚠️ Guarde essas credenciais — esta é a conta de administrador raiz de toda a plataforma.

Passo 9 — Configuração do Cron Job​

O assistente mostra o comando cron exato para o seu servidor. Copie-o e adicione ao painel de controle da sua hospedagem:

* * * * * /usr/bin/php /home/usuario/public_html/cron.php >> /dev/null 2>&1

No cPanel: Cron Jobs → Adicionar Novo Cron Job → A cada Minuto → cole o comando.

Passo 10 — Finalizar​

Clique em Concluir Instalação. O assistente grava o arquivo .env e executa as migrações. Quando concluído, você é redirecionado para a página de login do Super Admin em /super-admin.

Após a Instalação​

  1. Faça login em /super-admin com as credenciais que você acabou de criar.
  2. Crie seu primeiro Inquilino.
  3. Faça login no painel de administração do inquilino em /admin (ou inquilino.seudominio.com/admin).

Resolução de Problemas​

ProblemaSolução
Página em branco em /installVerifique se .htaccess existe e se mod_rewrite está ativo
"Falha na conexão com o banco"Verifique as credenciais; certifique-se de que o usuário tem privilégios completos
Travado na verificação de requisitosInstale a extensão PHP ausente via cPanel → Extensões PHP
Erro 500 após instalaçãoVerifique storage/logs/laravel.log via Gerenciador de Arquivos

➡ Veja também: Guia de Hospedagem Compartilhada