Saltar al contenido principal

Asistente de Instalación

LeadHub se instala completamente a través de tu navegador web. No hay línea de comandos, ni terminal, ni SSH. Subes los archivos, abres una URL y sigues cinco pasos simples. Esta guía te acompaña en todo el proceso de principio a fin.

Tiempo total: aproximadamente 10–20 minutos.

Antes de Comenzar​

Asegúrate de que tu servidor cumple con los requisitos listados en la guía de Requisitos del Servidor. En particular, confirma que:

  • PHP 8.3 o superior está activo para tu dominio
  • Tienes una base de datos MySQL (o MariaDB) disponible — o puedes crear una (instrucciones a continuación)
  • Tus directorios storage/ y bootstrap/cache/ son escribibles
  • Tienes alrededor de 500 MB de espacio libre en disco

Paso 1 — Sube los Archivos de LeadHub a tu Servidor​

Descarga el paquete​

Después de comprar LeadHub, descarga el paquete ZIP desde tu correo de confirmación de compra o desde la página de Descargas de Envato. El archivo se llamará algo como leadhub-v1.0.0.zip.

Dentro del ZIP encontrarás todo lo que LeadHub necesita — incluyendo el directorio vendor/ (todas las dependencias PHP), CSS y JavaScript precompilados, y el instalador. No necesitas instalar nada por separado.

Subir via Administrador de Archivos de cPanel (método más fácil)​

Este es el método recomendado para la mayoría de usuarios en hosting compartido.

  1. Inicia sesión en tu cuenta de cPanel.
  2. Haz clic en File Manager en la sección Files.
  3. Navega a la carpeta donde quieres instalar LeadHub. Típicamente:
    • public_html/ si quieres LeadHub en tu dominio principal (ej. https://tudominio.com)
    • Un subdirectorio como public_html/leadhub/ si lo quieres en una ruta
    • Una carpeta de addon domain dedicada si configuraste un addon domain (recomendado — consulta la Guía de Hosting Compartido para detalles)
  4. Haz clic en Upload en la barra de herramientas.
  5. Sube el archivo leadhub-v1.0.0.zip.
  6. Después de que termine la subida, regresa al File Manager, haz clic derecho en el archivo ZIP y elige Extract.
  7. Extráelo en la carpeta correcta.

Subir via FTP​

Si prefieres FTP (usando un programa como FileZilla o Cyberduck):

  1. Conéctate a tu servidor usando tus credenciales FTP (host, usuario, contraseña, puerto 21).
  2. Navega a la carpeta destino en tu servidor (el panel derecho en FileZilla).
  3. Arrastra la carpeta leadhub descomprimida desde tu computadora al directorio del servidor.
  4. Espera a que todos los archivos terminen de subirse. Esto puede tomar 5–15 minutos dependiendo de tu velocidad de conexión — hay muchos archivos en el directorio vendor/.

Consejo: Es más rápido subir el archivo ZIP via File Manager y extraerlo en el servidor que subir miles de archivos individuales por FTP.

Paso 2 — Configura los Permisos de Archivos​

LeadHub necesita poder escribir en ciertos directorios. Los "permisos" son configuraciones que controlan quién puede leer, escribir o ejecutar archivos. Necesitas establecer los siguientes directorios con nivel de permiso 755 (a veces mostrado como rwxr-xr-x).

En el Administrador de Archivos de cPanel:​

  1. Abre File Manager y navega a tu carpeta de LeadHub.
  2. Haz clic derecho en la carpeta storage y elige Change Permissions.
  3. Establécelo en 755 y asegúrate de que la casilla "Recurse into subdirectories" esté marcada.
  4. Haz clic en Change Permissions.
  5. Repite esto para la carpeta bootstrap/cache (establécela en 755).

Eso es todo lo que necesitas hacer. El instalador también intentará corregir los permisos automáticamente si encuentra algún problema.

Paso 3 — Abre el Instalador en tu Navegador​

Abre tu navegador web y visita:

https://tudominio.com/install

Reemplaza tudominio.com con tu nombre de dominio real. Si instalaste LeadHub en un subdirectorio, inclúyelo en la ruta (ej. https://tudominio.com/leadhub/install).

El instalador se cargará y te guiará a través de cinco pasos. Cada paso es un formulario simple — complétalo y haz clic en Siguiente.

Si ves un error 404 "Página no encontrada": Verifica que tus archivos estén en la carpeta correcta y que el archivo public/.htaccess se haya subido correctamente. En cPanel, también confirma que mod_rewrite esté habilitado (está habilitado por defecto en virtualmente todos los hosts compartidos).

Si ves una página en blanco: PHP probablemente no está habilitado para esa carpeta, o la versión de PHP es muy antigua. Regresa a cPanel → MultiPHP Manager y confirma que PHP 8.3 está seleccionado para tu dominio.

Paso 1 del Instalador — Bienvenida y Verificación de Requisitos​

La primera página del instalador es la Verificación de Requisitos. LeadHub escanea automáticamente tu servidor y te muestra una lista de todo lo que necesita.

Verás marcas verdes junto a lo que funciona correctamente y advertencias rojas junto a lo que necesita atención. Esto es lo que verifica cada sección:

  • Versión de PHP — debe ser 8.3 o superior
  • Extensiones PHP — verifica las 13 extensiones requeridas (pdo, pdo_mysql, mbstring, openssl, tokenizer, xml, ctype, json, bcmath, fileinfo, curl, zip, gd)
  • Permisos de Directorio — verifica que storage/ y bootstrap/cache/ sean escribibles

Qué hacer si algo falla​

Versión de PHP muy baja: Ve a cPanel → MultiPHP Manager → cambia tu dominio a PHP 8.3. Regresa y actualiza la página del instalador.

Falta una extensión PHP: Ve a cPanel → Select PHP Version → busca la extensión faltante en la lista → marca la casilla → Save. Regresa y actualiza la página del instalador.

Un directorio no es escribible: Ve a cPanel → File Manager → clic derecho en la carpeta storage o bootstrap/cache → Change Permissions → establece en 755 y recursa en subdirectorios. Regresa y actualiza.

Una vez que todo muestre una marca verde, haz clic en el botón "Next: Database" para continuar.

Paso 2 del Instalador — Configuración de Base de Datos​

Este paso conecta LeadHub a tu base de datos MySQL. Necesitarás completar cuatro campos:

CampoQué ingresar
Database HostGeneralmente localhost o 127.0.0.1 — deja el valor predeterminado a menos que tu host diga lo contrario
PortGeneralmente 3306 — este es el puerto estándar de MySQL. Déjalo como está.
Database NameEl nombre de la base de datos MySQL que creaste (ver más abajo)
Database UsernameEl usuario MySQL que creaste (ver más abajo)
Database PasswordLa contraseña de ese usuario MySQL

Después de completarlos, el instalador probará la conexión inmediatamente cuando hagas clic en "Next: Admin Account". Si la conexión falla, te lo indicará en esta página para que puedas corregir los detalles.

Cómo crear una base de datos MySQL en cPanel​

Si aún no has creado una base de datos, así es como hacerlo:

  1. En cPanel, busca MySQL Databases (en la sección Databases).
  2. En "Create New Database", escribe un nombre (ej. leadhub) y haz clic en Create Database. Nota: cPanel prefijará automáticamente tu nombre de usuario (ej. miusuario_leadhub). Anota el nombre completo.
  3. Desplázate a "MySQL Users" y en "Add New User", crea un nombre de usuario (ej. leadhub_user) y una contraseña segura. Haz clic en Create User. Anota este usuario y contraseña.
  4. Desplázate a "Add User to Database". Selecciona el usuario y la base de datos que acabas de crear, luego haz clic en Add.
  5. Aparecerá una página preguntando qué permisos otorgar. Marca "All Privileges" y haz clic en Make Changes.

Ahora tienes una base de datos lista. Regresa al instalador e ingresa el nombre de la base de datos (el nombre completo con prefijo), usuario y contraseña.

Paso 3 del Instalador — Cuenta de Administrador​

Este paso crea la primera cuenta de administrador para LeadHub. Completa:

CampoQué ingresar
Your NameTu nombre completo (ej. "Juan García")
Email AddressTu dirección de correo — será tu nombre de usuario para iniciar sesión
PasswordUna contraseña segura (al menos 8 caracteres)
Confirm PasswordLa misma contraseña otra vez
Workspace NameEl nombre de tu organización o espacio de trabajo

¿Qué es un Workspace?

Un workspace es la cuenta de tu organización dentro de LeadHub. Todo en LeadHub — leads, pipelines, miembros del equipo, automatizaciones — pertenece a un workspace. Cuando instalas LeadHub por primera vez, se crea un workspace automáticamente para ti. Eres establecido como su propietario con permisos completos de Super Admin.

Piensa en un workspace como la cuenta de tu empresa. El nombre del workspace que ingreses aquí aparecerá en todo el panel de administración.

Haz clic en "Next: License" cuando termines.

Paso 4 del Instalador — Licencia​

Este paso te permite ingresar tu código de compra de Envato para activar tu licencia. Esta es la clave de licencia que recibes al comprar LeadHub en CodeCanyon (Envato Market).

Para encontrar tu código de compra:

  1. Inicia sesión en tu cuenta de Envato Market / CodeCanyon.
  2. Ve a tu perfil → Downloads.
  3. Encuentra LeadHub en tu lista de compras.
  4. Haz clic en "Download" → "License certificate & purchase code".
  5. Copia el código de compra (se ve así: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).

Pégalo en el campo License Key y haz clic en "Next: Finish".

También puedes omitir este paso dejando el campo vacío y haciendo clic en Next. LeadHub se instalará sin licencia. Puedes agregar tu clave de licencia después en Configuración → Licencia desde el panel de administración.

Paso 5 del Instalador — Finalizar​

Este es el paso final. Verás un resumen de tus opciones de configuración antes de que comience la instalación. Haz clic en "Install LeadHub" para comenzar.

El instalador ahora hará lo siguiente — todo automáticamente, sin necesidad de tu intervención:

  1. Escribe el archivo de configuración (.env) — almacena tu conexión a la base de datos, clave de la app y configuraciones básicas.
  2. Ejecuta las migraciones de la base de datos — crea todas las tablas que LeadHub necesita.
  3. Siembra la base de datos — inserta los roles y permisos predeterminados.
  4. Crea tu cuenta de administrador — crea tu cuenta con los detalles del Paso 3.
  5. Crea tu workspace — configura tu workspace contigo como propietario.
  6. Vincula la carpeta de almacenamiento — crea un enlace para que los archivos subidos sean accesibles desde el navegador.
  7. Almacena en caché la configuración — acelera la aplicación al cachear las configuraciones.

Este proceso toma aproximadamente 30–90 segundos. Verás un indicador de progreso. Cuando se complete, verás un mensaje de éxito y serás redirigido automáticamente a /admin donde puedes iniciar sesión con el correo y contraseña que creaste en el Paso 3.

La instalación está completa.

Lista de Verificación Post-Instalación​

Después de que el asistente termine y hayas iniciado sesión, haz estas cosas inmediatamente:

1. Configura el Cron Job (CRÍTICO)​

Sin el cron job, tus automatizaciones no se ejecutarán, los webhooks de fuentes de leads se acumularán sin procesar, y las notificaciones por correo no se enviarán.

El único cron job que necesitas agregar es:

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

Esto debe ejecutarse cada minuto. Consulta la Guía de Hosting Compartido para instrucciones paso a paso sobre cómo agregar este cron job.

2. Configura el Email​

Ve a Configuración → Email en el panel de administración. Ingresa los detalles de tu servidor SMTP. Haz clic en "Send Test Email" para verificar que funcione.

3. Sube tu Logo y Configura tu Marca​

Ve a Configuración → Branding. Sube tu logo, establece el nombre de tu aplicación y elige tus colores primarios y de acento.

4. Crea tu Primer Pipeline​

Ve a Pipelines en la barra lateral. Crea un pipeline y agrega etapas (ej. "Nuevo", "Contactado", "Calificado", "Propuesta", "Ganado", "Perdido").

5. Conecta tu Primera Fuente de Leads​

Ve a Lead Sources en la barra lateral. Conecta tu primera fuente — puede ser Facebook Lead Ads, un formulario de Google Ads, un formulario web o entrada manual.

Cómo Re-ejecutar el Instalador​

Si algo sale mal durante la instalación, o si necesitas comenzar de nuevo, puedes re-ejecutar el instalador eliminando el archivo de bloqueo de instalación.

En el File Manager de cPanel, navega a tu carpeta de LeadHub, luego ve a storage/. Elimina el archivo llamado installed.lock. Luego visita https://tudominio.com/install de nuevo en tu navegador.

Advertencia: Re-ejecutar el instalador después de una instalación completa sobrescribirá tu archivo .env y re-ejecutará las migraciones. Tus datos existentes deberían sobrevivir porque las migraciones usan lógica "create if not exists", pero es más seguro hacer una copia de seguridad de tu base de datos primero.

Solución de Problemas​

ProblemaCausa probableSolución
"Page not found" al visitar /installArchivos no están en la carpeta correcta, o mod_rewrite no funcionaVerifica que los archivos estén en la ubicación correcta; confirma que public/.htaccess se subió; contacta a tu host sobre mod_rewrite
Página en blancoError PHP o versión PHP incorrectaCambia a PHP 8.3 en cPanel MultiPHP Manager
"Cannot connect to database" en el Paso 2Credenciales de base de datos incorrectasVerifica el nombre de la base de datos (incluye el prefijo de cPanel), usuario y contraseña
Página de requisitos muestra advertencias rojasExtensiones PHP no habilitadasVe a cPanel → Select PHP Version, habilita las extensiones faltantes, actualiza el instalador
Advertencia "storage is not writable"Permisos no configurados correctamenteEstablece storage/ a 755 recursivamente en el File Manager de cPanel
Instalador se congela en "Installing..."Límite de memoria PHP muy bajo o problema de base de datosIntenta refrescar; verifica el límite de memoria PHP en cPanel (necesita ser al menos 128 MB, preferiblemente 256 MB)
Redirigido a /admin pero no puedes iniciar sesiónSesión no se guardaVerifica que storage/framework/sessions/ exista y sea escribible
Error "installation failed" en el paso finalConexión a base de datos perdida o error de escritura de archivoVerifica tus credenciales de base de datos; verifica que .env pueda ser escrito