Requisitos do Servidor
Esta página lista tudo o que o seu servidor web precisa para executar o LeadHub. Não se preocupe — nada disso requer conhecimentos técnicos. Se você estiver usando uma conta de hospedagem compartilhada padrão (cPanel, Plesk, DirectAdmin), quase tudo nesta lista já está em vigor. Este guia mostrará exatamente como verificar.
Resumo Rápido
| Requisito | Mínimo | Notas |
|---|---|---|
| PHP | 8.3 ou superior | 8.2 NÃO funcionará |
| Banco de dados | MySQL 8.0+ ou MariaDB 10.4+ | Ambos funcionam |
| Servidor web | Apache ou Nginx | Ambos funcionam |
| Espaço em disco | ~500 MB | Para arquivos + banco de dados |
| RAM | 512 MB mínimo | Funciona em hospedagem compartilhada |
| SSH / terminal | NÃO necessário | Tudo é feito no navegador |
| Redis | NÃO necessário | Não é necessário de forma alguma |
| Composer | NÃO necessário | Pré-compilado no zip |
| Node.js / npm | NÃO necessário | Pré-compilado no zip |
| Supervisor | NÃO necessário | cron.php cuida de tudo |
Versão do PHP — 8.3 ou Superior
O LeadHub requer PHP 8.3 ou mais recente. PHP 8.2 não funcionará. PHP 8.4 é suportado.
Pense no PHP como o motor do seu carro — é o que realmente executa o código da aplicação. A maioria das contas de hospedagem modernas oferece múltiplas versões do PHP e permite que você alterne entre elas sem nenhum conhecimento técnico.
Como verificar e alterar sua versão do PHP no cPanel
- Faça login na sua conta cPanel.
- Procure o ícone "MultiPHP Manager" (geralmente na seção "Software").
- Clique nele.
- Encontre o nome do seu domínio na lista.
- Veja a versão do PHP mostrada ao lado.
- Se mostrar algo inferior ao PHP 8.3 (por exemplo, 7.4, 8.0, 8.1 ou 8.2), clique no menu suspenso e altere para PHP 8.3 (ou 8.4 se disponível).
- Clique em Apply.
É só isso. A alteração entra em vigor imediatamente.
Como verificar sua versão do PHP no Plesk
- Faça login no Plesk.
- Clique em Websites & Domains.
- Encontre seu domínio e clique em PHP Settings (ou procure "PHP version" na linha do domínio).
- Escolha PHP 8.3 ou 8.4 no menu suspenso e clique em OK.
Como verificar sua versão do PHP no DirectAdmin
- Faça login no DirectAdmin.
- Vá para Domain Setup e selecione seu domínio.
- Procure uma opção "PHP Version" e selecione 8.3 ou superior.
Banco de Dados — MySQL 8.0+ ou MariaDB 10.4+
O LeadHub armazena todos os seus dados (leads, configurações, usuários, automações, etc.) em um banco de dados MySQL. Pense no banco de dados como o arquivo onde todas as suas informações ficam guardadas.
- MySQL 8.0 ou mais recente — perfeitamente suportado
- MariaDB 10.4 ou mais recente — perfeitamente suportado (MariaDB é uma alternativa direta ao MySQL; muitas hospedagens compartilhadas a utilizam por padrão)
Você NÃO precisa configurar o banco de dados antes de executar o instalador. O assistente de instalação guiará você passo a passo para criar a conexão.
Servidor Web — Apache ou Nginx
Seu provedor de hospedagem executa um deles automaticamente. Você não precisa instalar nem configurar nada.
- Apache (o mais comum em hospedagem compartilhada cPanel) — funciona perfeitamente. O LeadHub inclui um arquivo
.htaccesspré-configurado que lida com todas as reescritas de URL necessárias automaticamente. - Nginx (comum em VPS e algumas hospedagens gerenciadas) — funciona perfeitamente. Seu provedor de hospedagem gerencia a configuração do Nginx.
Extensões PHP Necessárias
Extensões PHP são pequenos complementos que dão ao PHP capacidades adicionais. Pense nelas como aplicativos no seu celular — o celular funciona bem sem alguns deles, mas certas funcionalidades requerem aplicativos específicos instalados.
O assistente de instalação verifica automaticamente se todas as extensões necessárias estão presentes e mostrará um sinal verde ou um aviso vermelho para cada uma. Aqui está o que cada extensão faz, em linguagem simples:
| Extensão | O que faz |
|---|---|
| pdo | O sistema mestre de "conexão com banco de dados" — permite que o PHP se comunique com bancos de dados |
| pdo_mysql | A parte específica do MySQL dessa conexão — permite que o LeadHub se comunique com seu banco de dados MySQL/MariaDB |
| mbstring | Lida com texto multi-byte — essencial para exibir corretamente nomes, e-mails e conteúdo em idiomas além do inglês |
| openssl | Lida com criptografia e segurança — usado para criptografar senhas, gerar tokens seguros e fazer conexões HTTPS |
| tokenizer | Ajuda o PHP a ler e analisar seu próprio código — exigido pelo framework Laravel que alimenta o LeadHub |
| xml | Permite que o PHP leia e escreva dados XML — usado na comunicação com alguns serviços externos e APIs |
| ctype | Verifica se o texto contém apenas certos tipos de caracteres — usado na validação de entrada |
| json | Permite que o PHP trabalhe com dados JSON — JSON é a linguagem universal que serviços web usam para trocar dados |
| bcmath | Lida com cálculos matemáticos muito precisos — usado para cálculos de pontuação de leads onde a precisão decimal importa |
| fileinfo | Detecta qual é o verdadeiro tipo de um arquivo — usado quando usuários fazem upload de logos, importações, etc. |
| curl | Permite que o PHP faça requisições web de saída — usado para conectar ao Facebook Lead Ads, Google Ads, webhooks e todas as integrações externas |
| zip | Permite que o PHP crie e abra arquivos ZIP — usado para exportações em massa e importações de arquivos |
| gd | Biblioteca de processamento de imagens — usada para redimensionar imagens enviadas como logos e avatares |
Todas essas extensões estão habilitadas por padrão na grande maioria das contas de hospedagem compartilhada. Se alguma estiver faltando, você pode habilitá-la pelo painel de controle da sua hospedagem.
Como habilitar uma extensão PHP no cPanel
- Faça login no cPanel.
- Procure "Select PHP Version" na seção Software. (É diferente do MultiPHP Manager — este controla quais extensões estão ativas.)
- Clique nele.
- Certifique-se de que a versão correta do PHP está mostrada no topo (ex.: PHP 8.3).
- Você verá uma longa lista de caixas de seleção — uma para cada extensão disponível.
- Encontre a extensão que precisa (ex.:
gdoucurl) e marque a caixa. - Clique em Save.
A extensão está agora ativa imediatamente.
Diretórios com Permissão de Escrita
O LeadHub precisa poder gravar arquivos em certas pastas: uma para armazenar arquivos enviados, dados em cache, logs e dados de sessão; e outra para cache de arquivos de configuração.
Esses diretórios (e todas as pastas dentro deles) precisam ter permissões de escrita:
storage/storage/app/storage/app/public/storage/framework/storage/framework/cache/storage/framework/sessions/storage/framework/views/storage/logs/bootstrap/cache/
Na prática, definir essas permissões é algo que você faz uma vez durante a instalação usando o gerenciador de arquivos da sua hospedagem. O guia do Assistente de Instalação cobre exatamente como fazer isso passo a passo.
E-mail — Qualquer Provedor SMTP
O LeadHub pode enviar e-mails (e-mails de convite, notificações de leads, e-mails de automação, etc.) usando qualquer serviço de e-mail SMTP padrão. SMTP é simplesmente a tecnologia padrão que todos os servidores de e-mail usam para enviar correspondência.
Você NÃO configura o e-mail durante a instalação. Após a conclusão da instalação, você configura o e-mail no painel de administração em Configurações → E-mail. Você inserirá seu host SMTP, porta, nome de usuário e senha — todos fornecidos pelo seu provedor de e-mail.
Provedores de e-mail compatíveis incluem (mas não se limitam a):
- Gmail / Google Workspace
- Outlook / Microsoft 365
- Amazon SES
- Mailgun
- SendGrid
- Brevo (anteriormente Sendinblue)
- Postmark
- Qualquer outro serviço SMTP padrão
SSL / HTTPS
HTTPS é fortemente recomendado e praticamente obrigatório para uma instalação profissional. O LeadHub lida com senhas, dados pessoais e credenciais de API — tudo isso deve trafegar por uma conexão criptografada.
A maioria dos provedores de hospedagem oferece certificados SSL gratuitos através do Let's Encrypt, que podem ser ativados com um clique no painel do cPanel ou Plesk. Procure por "SSL/TLS" ou "Let's Encrypt" no seu painel de controle. Ative-o antes de iniciar a instalação para que sua URL do LeadHub use https:// desde o primeiro dia.
Espaço em Disco
O LeadHub em si (todos os arquivos da aplicação, a pasta vendor/ e os assets compilados) ocupa aproximadamente 250 MB a 350 MB em disco. Recomendamos ter pelo menos 500 MB livres para acomodar confortavelmente os arquivos da aplicação, seu banco de dados, arquivos enviados (logos, importações) e arquivos de log.
RAM (Memória)
O LeadHub funciona confortavelmente em planos típicos de hospedagem compartilhada. Você não precisa se preocupar com RAM na maioria dos planos. Para referência:
- 512 MB RAM — mínimo, funciona bem para instalações pequenas
- 1 GB RAM — confortável para equipes de até 20 pessoas e volumes moderados de leads
- 2 GB+ RAM — recomendado para instalações de alto volume com milhares de leads por dia
Se seu plano de hospedagem compartilhada especifica um limite de memória PHP, o LeadHub funciona bem com 256 MB por requisição, que é o padrão na maioria das hospedagens compartilhadas. Você pode verificar seu limite de memória PHP no cPanel indo em Select PHP Version e procurando memory_limit na lista de opções do PHP.
O Que Você NÃO Precisa
Isso é importante saber desde o início. Diferente de algumas plataformas, o LeadHub é projetado especificamente para funcionar sem nada do seguinte:
- Sem SSH / acesso ao terminal — você nunca precisa fazer login no seu servidor via linha de comando
- Sem comandos artisan — não há comandos
php artisanpara executar, nunca - Sem Composer — a pasta
vendor/com todas as dependências já está incluída no pacote de download - Sem Node.js ou npm — todos os assets de JavaScript e CSS estão pré-compilados e incluídos no pacote
- Sem Redis — o LeadHub usa cache e sessões baseados em arquivo por padrão, o que funciona em qualquer hospedagem compartilhada
- Sem Supervisor — o processamento de tarefas em segundo plano e tarefas agendadas são gerenciados inteiramente pelo
cron.php, que executa como um cron job padrão de hospedagem - Sem acesso root / administrador do servidor — permissões de usuário padrão de hospedagem web são suficientes
Lista de Verificação Rápida
Use isto antes de iniciar a instalação:
- PHP 8.3 ou superior está ativo para meu domínio
- Banco de dados MySQL 8.0+ ou MariaDB 10.4+ está disponível (cPanel fornece isso)
- Apache (com mod_rewrite) ou Nginx é meu servidor web
- Tenho pelo menos 500 MB de espaço livre em disco
- Tenho um cliente FTP ou posso usar o Gerenciador de Arquivos do cPanel para fazer upload de arquivos
- Tenho uma conta de e-mail SMTP pronta (pode ser configurada após a instalação)
- O certificado SSL está ativo no meu domínio (fortemente recomendado)
Se tudo está marcado, você está pronto para instalar. Prossiga para o guia do Assistente de Instalação.