Pular para o conteúdo principal

Guia de Hospedagem Compartilhada

Este guia orienta a instalação do LeadHub em uma conta de hospedagem compartilhada típica com cPanel. Sem SSH, sem terminal, sem acesso root.

O Que Você Vai Usar​

  • Gerenciador de Arquivos do cPanel (ou FTP)
  • MySQL Databases do cPanel
  • Cron Jobs do cPanel
  • Um navegador web

Passo 1 — Criar o Banco de Dados​

  1. No cPanel, clique em MySQL Databases.
  2. Crie um novo banco de dados, ex.: usuario_leadhub.
  3. Crie um novo usuário de banco de dados, ex.: usuario_lhuser, com uma senha forte.
  4. Adicione o usuário ao banco de dados e conceda Todos os Privilégios.
  5. Anote: nome do banco, usuário, senha e host (geralmente localhost).

Passo 2 — Fazer Upload dos Arquivos​

Opção A — Gerenciador de Arquivos:

  1. Acesse cPanel → Gerenciador de Arquivos.
  2. Navegue até public_html/ (ou um subdiretório se quiser o LeadHub em uma pasta).
  3. Clique em Upload e faça upload do arquivo ZIP do LeadHub.
  4. Após o upload, clique com o botão direito no ZIP → Extrair para public_html/.

Opção B — FTP:

  1. Use FileZilla ou qualquer cliente FTP.
  2. Conecte-se à sua hospedagem com suas credenciais FTP.
  3. Faça upload de todos os arquivos da pasta extraída do LeadHub diretamente em public_html/.

⚠️ Certifique-se de que index.php esteja diretamente em public_html/ — não dentro de uma subpasta.

Passo 3 — Definir Permissões​

No Gerenciador de Arquivos do cPanel:

  1. Selecione a pasta storage/ → clique com o botão direito → Alterar Permissões → defina como 755, marque Recursar em subdiretórios.
  2. Faça o mesmo para bootstrap/cache/.

Passo 4 — Executar o Instalador​

Abra seu navegador e acesse:

https://seudominio.com/install

Conclua o assistente seguindo o guia de instalação.

Passo 5 — Configurar o Cron Job​

  1. No cPanel, clique em Cron Jobs.
  2. Em Adicionar Novo Cron Job, defina Configurações Comuns para "A cada Minuto (* * * * *)".
  3. No campo Comando, insira: 
    /usr/bin/php /home/seuusuario/public_html/cron.php >> /dev/null 2>&1

    Substitua seuusuario pelo seu nome de usuário real do cPanel e ajuste o caminho se o LeadHub estiver em um subdiretório.

  4. Clique em Adicionar Novo Cron Job.

Passo 6 — Verificar se o Cron Está Funcionando​

Após 2-3 minutos, no painel Super Admin do LeadHub acesse Saúde do Sistema. O status da fila deve aparecer em verde. Se mostrar "fila não está em execução", verifique novamente o caminho do cron.

Instalando em um Subdiretório​

Se quiser o LeadHub em seudominio.com/leadhub/ em vez da raiz:

  1. Faça upload dos arquivos em public_html/leadhub/.
  2. Durante a instalação, defina a URL da Aplicação como https://seudominio.com/leadhub.
  3. O caminho do cron se torna /home/seuusuario/public_html/leadhub/cron.php.

Instalação em Subdomínio​

Para instalar o LeadHub em app.seudominio.com:

  1. No cPanel → Domínios (ou Subdomínios), crie app.seudominio.com apontando para ex.: public_html/leadhub/.
  2. Faça upload dos arquivos em public_html/leadhub/.
  3. Defina a URL da Aplicação como https://app.seudominio.com.

Verificação da Versão do PHP​

Se seu cPanel tem MultiPHP Manager:

  1. Acesse MultiPHP Manager.
  2. Encontre seu domínio/subdomínio.
  3. Selecione PHP 8.4 (ou o mais alto 8.x disponível).
  4. Salve.

Problemas Comuns no cPanel​

ProblemaSolução
.htaccess não funcionaHabilite mod_rewrite via cPanel → Apache Handlers, ou entre em contato com a hospedagem
Erro Interno do Servidor 500Verifique storage/logs/laravel.log no Gerenciador de Arquivos
Extensão PHP ausentecPanel → Selecionar Versão do PHP → habilite a extensão ausente
Fila não está em execuçãoVerifique o caminho do cron — use o caminho exato indicado em Saúde do Sistema
Permissões de arquivo negadasDefina storage/ e bootstrap/cache/ como 755 recursivamente