Saltar al contenido principal

Guía de Alojamiento Compartido

Esta guía explica cómo instalar LeadHub en una cuenta de alojamiento compartido típica con cPanel. No se requiere SSH, terminal ni acceso root.

Lo Que Necesitarás​

  • Administrador de Archivos de cPanel (o FTP)
  • Bases de Datos MySQL de cPanel
  • Cron Jobs de cPanel
  • Un navegador web

Paso 1 — Crear la Base de Datos​

  1. En cPanel, haz clic en MySQL Databases.
  2. Crea una nueva base de datos, p. ej. usuario_leadhub.
  3. Crea un nuevo usuario de base de datos, p. ej. usuario_lhuser, con una contraseña segura.
  4. Agrega el usuario a la base de datos y otorga Todos los Privilegios.
  5. Anota: nombre de la base de datos, usuario, contraseña y host (normalmente localhost).

Paso 2 — Subir los Archivos​

Opción A — Administrador de Archivos:

  1. Ve a cPanel → Administrador de Archivos.
  2. Navega a public_html/ (o un subdirectorio si deseas LeadHub en una carpeta).
  3. Haz clic en Subir y sube el archivo ZIP de LeadHub.
  4. Tras la carga, haz clic derecho en el ZIP → Extraer en public_html/.

Opción B — FTP:

  1. Usa FileZilla o cualquier cliente FTP.
  2. Conéctate a tu alojamiento con tus credenciales FTP.
  3. Sube todos los archivos de la carpeta extraída de LeadHub directamente a public_html/.

⚠️ Asegúrate de que index.php esté directamente en public_html/ — no dentro de una subcarpeta.

Paso 3 — Establecer Permisos​

En el Administrador de Archivos de cPanel:

  1. Selecciona la carpeta storage/ → clic derecho → Cambiar Permisos → establece en 755, marca Aplicar recursivamente a subdirectorios.
  2. Haz lo mismo para bootstrap/cache/.

Paso 4 — Ejecutar el Instalador​

Abre tu navegador y ve a:

https://tudominio.com/install

Completa el asistente siguiendo la guía de Instalación.

Paso 5 — Configurar el Cron Job​

  1. En cPanel, haz clic en Cron Jobs.
  2. En Agregar Nuevo Cron Job, configura Configuración Común como "Cada Minuto (* * * * *)".
  3. En el campo Comando, introduce: 
    /usr/bin/php /home/tuusuario/public_html/cron.php >> /dev/null 2>&1

    Reemplaza tuusuario con tu nombre de usuario real de cPanel y ajusta la ruta si LeadHub está en un subdirectorio.

  4. Haz clic en Agregar Nuevo Cron Job.

Paso 6 — Verificar que el Cron Está Funcionando​

Tras 2-3 minutos, ve al panel de Super Admin de LeadHub → Estado del Sistema. El estado de la cola debe mostrarse en verde. Si muestra "cola no ejecutándose", revisa la ruta del cron.

Instalación en un Subdirectorio​

Si deseas LeadHub en tudominio.com/leadhub/ en lugar de la raíz:

  1. Sube los archivos a public_html/leadhub/.
  2. Durante la instalación, establece URL de la App como https://tudominio.com/leadhub.
  3. La ruta del cron pasa a ser /home/tuusuario/public_html/leadhub/cron.php.

Instalación en Subdominio​

Para instalar LeadHub en app.tudominio.com:

  1. En cPanel → Dominios (o Subdominios), crea app.tudominio.com apuntando a p. ej. public_html/leadhub/.
  2. Sube los archivos a public_html/leadhub/.
  3. Establece URL de la App como https://app.tudominio.com.

Verificación de Versión de PHP​

Si tu cPanel tiene MultiPHP Manager:

  1. Ve a MultiPHP Manager.
  2. Busca tu dominio/subdominio.
  3. Selecciona PHP 8.4 (o la versión 8.x más alta disponible).
  4. Guarda.

Problemas Comunes en cPanel​

ProblemaSolución
.htaccess no funcionaActiva mod_rewrite en cPanel → Apache Handlers, o contacta al proveedor
Error 500 Interno del ServidorRevisa storage/logs/laravel.log en el Administrador de Archivos
Extensión PHP faltantecPanel → Seleccionar Versión de PHP → activa la extensión faltante
Cola no ejecutándoseVerifica la ruta del cron — usa la ruta exacta de Estado del Sistema
Permisos de archivos denegadosEstablece storage/ y bootstrap/cache/ en 755 recursivamente