Guia de Hospedagem Compartilhada (cPanel, Plesk, DirectAdmin)
O LeadHub foi construído desde o início para funcionar em hospedagem compartilhada. Você não precisa de um VPS, servidor dedicado, acesso SSH ou qualquer conhecimento de linha de comando. Se você consegue fazer upload de um arquivo e preencher um formulário web, pode instalar e executar o LeadHub.
Este guia cobre tudo o que é específico para ambientes de hospedagem compartilhada.
LeadHub em Hospedagem Compartilhada — O Que Você Precisa Saber
O que você absolutamente NÃO precisa
- Sem SSH / terminal / linha de comando — nunca
- Sem comandos artisan
- Sem Composer — todas as dependências PHP estão pré-instaladas na pasta
vendor/ - Sem Node.js ou npm — todo CSS e JavaScript está pré-compilado
- Sem Redis — o LeadHub usa sessões e cache baseados em arquivo por padrão
- Sem Supervisor — o arquivo
cron.phpsubstitui todo o processamento em segundo plano - Sem acesso root
O que você PRECISA
- PHP 8.3 ou superior
- Um banco de dados MySQL
- A capacidade de adicionar um cron job
- Cerca de 500 MB de espaço livre em disco
- Apache com mod_rewrite habilitado
Escolhendo Como Instalar — Opção A ou Opção B
- Opção A — Addon Domain (Recomendado): O LeadHub recebe seu próprio domínio ou subdomínio dedicado (ex.:
leads.seudominio.com). - Opção B — Instalação direta em public_html: Instala o LeadHub diretamente na pasta
public_html/.
Opção A — Addon Domain (Recomendado)
Passo 1: Criar um Addon Domain ou Subdomínio
No cPanel:
- Faça login no cPanel.
- Clique em Addon Domains.
- Preencha:
- New Domain Name: ex.:
leads.seudominio.com - Document Root: altere para
public_html/leadhub/public
- New Domain Name: ex.:
- Clique em Add Domain.
Por que apontar para
public/? Os arquivos da aplicação LeadHub são projetados para ficar acima da raiz web. Apenas a pastapublic/deve ser acessível pelo navegador.
No Plesk: Adicione domínio/subdomínio e defina a raiz web para leadhub/public.
No DirectAdmin: Adicione domínio e defina o document root para leadhub/public.
Passo 2: Faça Upload dos Arquivos
public_html/
leadhub/
app/
public/ ← seu addon domain aponta aqui
storage/
vendor/
cron.php
...etc
Passo 3: Crie um Banco de Dados MySQL
No cPanel → MySQL Databases: crie um banco, um usuário e conceda todos os privilégios.
Passo 4: Defina as Permissões
storage→ 755 (recursivo)bootstrap/cache→ 755
Passo 5: Execute o Assistente de Instalação
Acesse https://leads.seudominio.com/install e siga os cinco passos.
Opção B — Instalação Direta em public_html/
Mova tudo de public_html/leadhub/public/ para public_html/, e também todas as outras pastas do LeadHub. O index.php detecta automaticamente essa disposição.
Configurar o Cron Job — CRÍTICO
Este é o passo mais importante após a instalação.
No cPanel
-
Seção Advanced → Cron Jobs.
-
Todos os campos de tempo como
*(a cada minuto). -
Comando:
php /home/seunomeusuario/public_html/leadhub/cron.php >> /dev/null 2>&1
No Plesk
php /var/www/vhosts/seudominio.com/leadhub/cron.php >> /dev/null 2>&1
No DirectAdmin
php /home/seunomeusuario/domains/seudominio.com/leadhub/cron.php >> /dev/null 2>&1
Encontrando o Caminho Correto do PHP
Caminhos comuns: /usr/local/bin/php, /usr/bin/php, /opt/cpanel/ea-php83/root/usr/bin/php
Alternativa: Cron Baseado em Web
Adicione CRON_SECRET=SeuSegredoAleatorio ao .env e configure uma URL de cron:
https://seudominio.com/cron.php?token=SeuSegredoAleatorio
Referência de Permissões
| Pasta / Arquivo | Permissão | Motivo |
|---|---|---|
storage/ (e subpastas) | 755 | Sessões, logs, cache, arquivos enviados |
bootstrap/cache/ | 755 | Configuração compilada |
public/ | 755 | O servidor web lê arquivos aqui |
| Arquivos PHP | 644 | Legíveis pelo servidor web |
.env | 640 ou 644 | Sensível |
Selecionando a Versão Correta do PHP
cPanel: Software → MultiPHP Manager → PHP 8.3 → Apply. Plesk: Websites & Domains → PHP Settings → PHP 8.3 → OK. DirectAdmin: Domain Setup → PHP Version → 8.3.
Solução de Problemas
| Problema | Causa provável | Solução |
|---|---|---|
| Página em branco | Versão PHP incorreta | Mude para PHP 8.3 |
| Erro 404 | Arquivos na pasta errada ou mod_rewrite inativo | Verifique localização e .htaccess |
| Erro 403 | Permissões incorretas | Defina storage/ e public/ como 755 |
| /install não acessível | Problema de caminho | index.php deve estar em public_html/ |
| Cron job não funciona | Caminho incorreto | Verifique caminho completo |
| Automações não disparam | Cron não configurado | Verifique o cron job |
| Uploads falham | storage sem permissão de escrita | Defina storage/ como 755 recursivamente |
| E-mails não são enviados | E-mail não configurado | Configurações → E-mail, configure SMTP |
| Conexão com banco falha | Credenciais incorretas | Verifique nome, usuário e senha |
| Tela branca após login | Problema de sessão | Verifique storage/framework/sessions/ |
| Instalador diz já instalado | installed.lock existe | Delete de storage/ |