Pular para o conteúdo principal

Assistente de Instalação

O LeadHub é instalado inteiramente pelo seu navegador web. Não há linha de comando, nem terminal, nem SSH. Você faz upload dos arquivos, abre uma URL e segue cinco passos simples. Este guia acompanha você em todo o processo.

Tempo total: aproximadamente 10 a 20 minutos.

Antes de Começar​

Certifique-se de que seu servidor atende aos requisitos listados no guia de Requisitos do Servidor. Em particular, confirme que:

  • PHP 8.3 ou superior está ativo para seu domínio
  • Você tem um banco de dados MySQL (ou MariaDB) disponível — ou pode criar um (instruções abaixo)
  • Seus diretórios storage/ e bootstrap/cache/ possuem permissão de escrita
  • Você tem cerca de 500 MB de espaço livre em disco

Passo 1 — Faça Upload dos Arquivos do LeadHub para seu Servidor​

Baixe o pacote​

Após comprar o LeadHub, baixe o pacote ZIP do seu email de confirmação de compra ou da página de Downloads do Envato. O arquivo terá um nome como leadhub-v1.0.0.zip.

Dentro do ZIP você encontrará tudo que o LeadHub precisa — incluindo a pasta vendor/, CSS e JavaScript pré-compilados e o próprio instalador.

Upload via Gerenciador de Arquivos do cPanel (método mais fácil)​

  1. Faça login na sua conta cPanel.
  2. Clique em File Manager na seção Files.
  3. Navegue até a pasta onde deseja instalar o LeadHub. Tipicamente:
    • public_html/ para o domínio principal
    • Um subdiretório como public_html/leadhub/
    • Uma pasta de addon domain dedicada (recomendado — veja o Guia de Hospedagem Compartilhada)
  4. Clique em Upload na barra de ferramentas.
  5. Faça upload do arquivo leadhub-v1.0.0.zip.
  6. Após o upload, clique com o botão direito no ZIP e escolha Extract.
  7. Extraia na pasta correta.

Upload via FTP​

  1. Conecte-se ao servidor usando suas credenciais FTP.
  2. Navegue até a pasta de destino no servidor.
  3. Arraste a pasta leadhub descompactada do seu computador para o servidor.
  4. Aguarde a conclusão do upload (5 a 15 minutos).

Dica: É mais rápido fazer upload do ZIP pelo File Manager e extrair no servidor do que fazer upload de milhares de arquivos individuais por FTP.

Passo 2 — Configure as Permissões de Arquivo​

Defina as seguintes pastas com permissão 755:

No Gerenciador de Arquivos do cPanel:​

  1. Abra o File Manager e navegue até a pasta do LeadHub.
  2. Clique com o botão direito em storage → Change Permissions.
  3. Defina como 755 e marque "Recurse into subdirectories".
  4. Clique em Change Permissions.
  5. Repita para bootstrap/cache (755).

Passo 3 — Abra o Instalador no Navegador​

https://seudominio.com/install

Se aparecer erro 404: Verifique a localização dos arquivos e se public/.htaccess foi enviado corretamente.

Se aparecer página em branco: Verifique a versão do PHP no cPanel → MultiPHP Manager.

Instalador Passo 1 — Boas-vindas e Verificação de Requisitos​

Verifica automaticamente:

  • Versão PHP — deve ser 8.3 ou superior
  • Extensões PHP — verifica as 13 extensões necessárias
  • Permissões de Diretório — verifica se storage/ e bootstrap/cache/ são graváveis

Quando tudo mostrar marcas verdes, clique em "Next: Database".

Instalador Passo 2 — Configuração do Banco de Dados​

CampoO que inserir
Database HostGeralmente localhost ou 127.0.0.1
PortGeralmente 3306
Database NameO nome do banco de dados MySQL que você criou
Database UsernameO usuário MySQL que você criou
Database PasswordA senha desse usuário MySQL

Como criar um banco de dados MySQL no cPanel​

  1. No cPanel, vá em MySQL Databases.
  2. Em "Create New Database", digite um nome → Create Database.
  3. Em "MySQL Users" → "Add New User", crie um usuário e senha → Create User.
  4. Em "Add User to Database", selecione o usuário e banco → Add.
  5. Marque "All Privileges" → Make Changes.

Instalador Passo 3 — Conta de Administrador​

CampoO que inserir
Your NameSeu nome completo
Email AddressSeu email (será seu login)
PasswordUma senha forte (mínimo 8 caracteres)
Confirm PasswordA mesma senha novamente
Workspace NameNome da sua organização

Um workspace é a conta da sua organização no LeadHub. Você será configurado como proprietário com permissões de Super Admin.

Clique em "Next: License".

Instalador Passo 4 — Licença​

Para encontrar seu código de compra:

  1. Faça login no Envato Market / CodeCanyon.
  2. Perfil → Downloads.
  3. Encontre o LeadHub → "Download" → "License certificate & purchase code".
  4. Copie o código.

Cole e clique em "Next: Finish". Você pode pular este passo e adicionar a licença depois.

Instalador Passo 5 — Finalização​

Clique em "Install LeadHub". O instalador executará automaticamente:

  1. Escrita do arquivo de configuração (.env)
  2. Execução das migrações do banco de dados
  3. Inserção dos dados iniciais (roles e permissões)
  4. Criação da conta de administrador
  5. Criação do workspace
  6. Vinculação da pasta de armazenamento
  7. Cache da configuração

Duração: 30 a 90 segundos. Você será redirecionado para /admin.

A instalação está completa.

Checklist Pós-Instalação​

1. Configure o Cron Job (CRÍTICO)​

php /home/seunomeusuario/leadhub/cron.php >> /dev/null 2>&1

Deve executar a cada minuto. Veja o Guia de Hospedagem Compartilhada.

2. Configure o Email​

Configurações → Email no painel de administração.

3. Upload do Logo e Branding​

Configurações → Branding.

4. Crie seu Primeiro Pipeline​

Pipelines na barra lateral.

5. Conecte sua Primeira Fonte de Leads​

Lead Sources na barra lateral.

Como Reexecutar o Instalador​

Delete installed.lock de storage/ e visite /install novamente.

Aviso: Faça backup do banco de dados antes, pois o .env será sobrescrito.

Solução de Problemas​

ProblemaCausa provávelSolução
"Page not found" em /installArquivos na pasta errada ou mod_rewrite inativoVerifique a localização dos arquivos e public/.htaccess
Página em brancoErro PHP ou versão erradaMude para PHP 8.3 no cPanel MultiPHP Manager
"Cannot connect to database"Credenciais erradasVerifique nome (com prefixo cPanel), usuário e senha
Avisos vermelhos nas extensõesExtensões não habilitadascPanel → Select PHP Version, habilite as que faltam
"storage is not writable"Permissões incorretasDefina storage/ como 755 recursivamente
Instalador trava em "Installing..."Limite de memória PHP baixoAtualize a página; verifique o limite de memória PHP
Redirecionado para /admin mas não consegue logarSessão não salvaVerifique se storage/framework/sessions/ existe e é gravável
Erro "installation failed"Conexão com banco perdidaVerifique credenciais e permissões de escrita do .env