Saltar al contenido principal

Instalación

LeadHub se instala completamente a través de un asistente basado en navegador. Sin SSH, sin terminal, sin Composer.

Antes de Comenzar​

✅ Confirma que tu servidor cumple los requisitos
✅ Crea una base de datos MySQL y un usuario de base de datos (anota las credenciales)
✅ Ten tu clave de licencia lista (de la compra en CodeCanyon)
✅ Ten acceso FTP/Administrador de Archivos de cPanel para subir los archivos

Paso 1 — Subir los Archivos​

  1. Descarga el paquete LeadHub desde CodeCanyon → Descargas.
  2. Extrae el archivo ZIP en tu computadora.
  3. Sube el contenido completo de la carpeta extraída a la raíz web (p. ej. public_html/) mediante FTP o el Administrador de Archivos de cPanel.

⚠️ No subas la carpeta exterior — sube su contenido para que index.php quede directamente en public_html/.

Paso 2 — Establecer Permisos de Archivos​

En alojamiento compartido suelen configurarse automáticamente, pero verifica:

RutaPermiso
storage/755 (recursivo)
bootstrap/cache/755
public/755

Paso 3 — Abrir el Asistente de Instalación​

Navega a tu dominio en un navegador:

https://tudominio.com/install

Si ves una página en blanco o un error, verifica que mod_rewrite esté habilitado y que .htaccess esté presente en la raíz.

Paso 4 — Verificación de Requisitos​

El asistente comprueba todos los requisitos de PHP automáticamente. Cualquier elemento con fallo se muestra en rojo con una breve explicación. Corrige los elementos en rojo antes de continuar.

Paso 5 — Configuración de la Base de Datos​

Introduce las credenciales de tu base de datos:

CampoDescripción
Host de Base de DatosNormalmente localhost o 127.0.0.1
Puerto de Base de DatosNormalmente 3306
Nombre de Base de DatosLa base de datos que creaste
Usuario de Base de DatosEl usuario de la base de datos
Contraseña de Base de DatosLa contraseña del usuario de la base de datos

Haz clic en Probar Conexión para verificar, luego en Siguiente.

Paso 6 — Configuración de la Aplicación​

CampoDescripción
URL de la AppTu dominio, p. ej. https://tudominio.com
Nombre de la AppSe muestra en la pestaña del navegador y en los correos
Zona HorariaTu zona horaria principal

Paso 7 — Clave de Licencia​

Introduce el Código de Compra (clave de licencia) de tu compra en CodeCanyon. El asistente lo valida en línea.

Paso 8 — Cuenta de Super Admin​

Crea la primera cuenta de super administrador:

CampoNotas
NombreTu nombre completo
Correo ElectrónicoUsado para iniciar sesión
ContraseñaMínimo 8 caracteres

⚠️ Guarda estas credenciales — esta es la cuenta de administrador raíz de toda la plataforma.

Paso 9 — Configuración del Cron Job​

El asistente muestra el comando cron exacto para tu servidor. Cópialo y agrégalo al panel de control de tu alojamiento:

* * * * * /usr/bin/php /home/usuario/public_html/cron.php >> /dev/null 2>&1

En cPanel: Cron Jobs → Agregar Nuevo Cron Job → Cada Minuto → pega el comando.

Paso 10 — Finalizar​

Haz clic en Completar Instalación. El asistente escribe el archivo .env y ejecuta las migraciones. Al terminar, serás redirigido a la página de inicio de sesión de Super Admin en /super-admin.

Después de la Instalación​

  1. Inicia sesión en /super-admin con las credenciales recién creadas.
  2. Crea tu primer Tenant.
  3. Inicia sesión en el panel de administración del tenant en /admin (o tenant.tudominio.com/admin).

Solución de Problemas​

ProblemaSolución
Página en blanco en /installVerifica que .htaccess exista y que mod_rewrite esté activo
"Error de conexión a la base de datos"Verifica credenciales; asegúrate de que el usuario BD tenga privilegios completos
Bloqueado en verificación de requisitosInstala la extensión PHP faltante desde cPanel → Extensiones PHP
Error 500 tras instalaciónRevisa storage/logs/laravel.log desde el Administrador de Archivos

➡ Ver también: Guía de Alojamiento Compartido