Requisitos del Servidor
Esta página enumera todo lo que tu servidor web necesita para ejecutar LeadHub. No te preocupes — nada de esto requiere conocimientos técnicos. Si estás usando una cuenta de hosting compartido estándar (cPanel, Plesk, DirectAdmin), casi todo en esta lista ya está disponible. Esta guía te mostrará exactamente cómo verificarlo.
Resumen Rápido
| Requisito | Mínimo | Notas |
|---|---|---|
| PHP | 8.3 o superior | 8.2 NO funcionará |
| Base de datos | MySQL 8.0+ o MariaDB 10.4+ | Ambos funcionan |
| Servidor web | Apache o Nginx | Ambos funcionan |
| Espacio en disco | ~500 MB | Para archivos + base de datos |
| RAM | 512 MB mínimo | Funciona en hosting compartido |
| SSH / terminal | NO requerido | Todo se hace en tu navegador |
| Redis | NO requerido | No se necesita en absoluto |
| Composer | NO requerido | Pre-compilado en el zip |
| Node.js / npm | NO requerido | Pre-compilado en el zip |
| Supervisor | NO requerido | cron.php se encarga de todo |
Versión de PHP — 8.3 o Superior
LeadHub requiere PHP 8.3 o más reciente. PHP 8.2 no funcionará. PHP 8.4 es compatible.
Piensa en PHP como el motor de tu auto — es lo que realmente ejecuta el código de la aplicación. La mayoría de las cuentas de hosting modernas ofrecen múltiples versiones de PHP y te permiten cambiar entre ellas sin ningún conocimiento técnico.
Cómo verificar y cambiar tu versión de PHP en cPanel
- Inicia sesión en tu cuenta de cPanel.
- Busca el ícono "MultiPHP Manager" (generalmente en la sección "Software").
- Haz clic en él.
- Encuentra tu nombre de dominio en la lista.
- Mira la versión de PHP que aparece junto a él.
- Si muestra algo inferior a PHP 8.3 (por ejemplo, 7.4, 8.0, 8.1 o 8.2), haz clic en el menú desplegable y cámbialo a PHP 8.3 (o 8.4 si está disponible).
- Haz clic en Apply.
Eso es todo. El cambio surte efecto inmediatamente.
Cómo verificar tu versión de PHP en Plesk
- Inicia sesión en Plesk.
- Haz clic en Websites & Domains.
- Encuentra tu dominio y haz clic en PHP Settings (o busca "PHP version" en la fila del dominio).
- Elige PHP 8.3 o 8.4 del menú desplegable y haz clic en OK.
Cómo verificar tu versión de PHP en DirectAdmin
- Inicia sesión en DirectAdmin.
- Ve a Domain Setup, luego selecciona tu dominio.
- Busca una opción "PHP Version" y selecciona 8.3 o superior.
Base de Datos — MySQL 8.0+ o MariaDB 10.4+
LeadHub almacena todos sus datos (leads, configuraciones, usuarios, automatizaciones, etc.) en una base de datos MySQL. Piensa en la base de datos como el archivador donde vive toda tu información.
- MySQL 8.0 o más reciente — perfectamente compatible
- MariaDB 10.4 o más reciente — perfectamente compatible (MariaDB es una alternativa directa a MySQL; muchos hosts compartidos la usan por defecto)
NO necesitas configurar la base de datos antes de ejecutar el instalador. El asistente de instalación te guiará paso a paso para crear la conexión.
Servidor Web — Apache o Nginx
Tu proveedor de hosting ejecuta uno de estos automáticamente. No necesitas instalar ni configurar nada tú mismo.
- Apache (el más común en hosting compartido con cPanel) — funciona perfectamente. LeadHub incluye un archivo
.htaccesspreconfigurado que maneja todas las reescrituras de URL necesarias automáticamente. - Nginx (común en VPS y algunos hosting gestionados) — funciona perfectamente. Tu proveedor de hosting gestiona la configuración de Nginx.
Extensiones PHP Requeridas
Las extensiones PHP son pequeños complementos que le dan a PHP capacidades adicionales. Piensa en ellas como aplicaciones en tu teléfono — el teléfono funciona bien sin algunas de ellas, pero ciertas funciones requieren aplicaciones específicas instaladas.
El asistente de instalación verifica automáticamente si todas las extensiones requeridas están presentes y te mostrará una marca verde clara o una advertencia roja para cada una. Esto es lo que hace cada extensión, en español sencillo:
| Extensión | Qué hace |
|---|---|
| pdo | El sistema maestro de "conexión a base de datos" — permite que PHP se comunique con bases de datos |
| pdo_mysql | La parte específica de MySQL de esa conexi ón — permite que LeadHub se comunique con tu base de datos MySQL/MariaDB |
| mbstring | Maneja texto multi-byte — esencial para mostrar correctamente nombres, correos y contenido en idiomas distintos al inglés |
| openssl | Maneja cifrado y seguridad — se usa para cifrar contraseñas, generar tokens seguros y hacer conexiones HTTPS |
| tokenizer | Ayuda a PHP a leer y analizar su propio código — requerido por el framework Laravel |
| xml | Permite a PHP leer y escribir datos XML — se usa al comunicarse con algunos servicios externos |
| ctype | Verifica si el texto contiene solo ciertos tipos de caracteres — se usa en validación de datos de entrada |
| json | Permite a PHP trabajar con datos JSON — JSON es el lenguaje universal que los servicios web usan para enviar datos |
| bcmath | Maneja cálculos matemáticos muy precisos — se usa para cálculos de puntuación de leads |
| fileinfo | Detecta qué tipo de archivo es algo realmente — se usa cuando los usuarios suben logos, importaciones, etc. |
| curl | Permite a PHP hacer solicitudes web salientes — se usa para conectar con Facebook Lead Ads, Google Ads, webhooks y todas las integraciones externas |
| zip | Permite a PHP crear y abrir archivos ZIP — se usa para exportaciones masivas e importaciones de archivos |
| gd | Biblioteca de procesamiento de imágenes — se usa para redimensionar imágenes subidas como logos y avatares |
Todas estas extensiones están habilitadas por defecto en la gran mayoría de cuentas de hosting compartido. Si alguna falta, puedes habilitarla a través del panel de control de tu hosting.
Cómo habilitar una extensión PHP en cPanel
- Inicia sesión en cPanel.
- Busca "Select PHP Version" en la sección Software. (Es diferente de MultiPHP Manager — este controla qué extensiones están activas.)
- Haz clic en él.
- Asegúrate de que tu versión correcta de PHP aparezca en la parte superior (ej. PHP 8.3).
- Verás una larga lista de casillas de verificación — una para cada extensión disponible.
- Encuentra la extensión que necesitas (ej.
gdocurl) y marca la casilla. - Haz clic en Save.
La extensión ya está activa inmediatamente.
Directorios con Permisos de Escritura
LeadHub necesita poder escribir archivos en ciertos directorios: uno para almacenar archivos subidos, datos en caché, logs y datos de sesión; y otro para cachear archivos de configuración.
Estos directorios (y todas las carpetas dentro de ellos) necesitan permisos de escritura:
storage/storage/app/storage/app/public/storage/framework/storage/framework/cache/storage/framework/sessions/storage/framework/views/storage/logs/bootstrap/cache/
En la práctica, establecer estos permisos es algo que haces una vez durante la instalación usando el administrador de archivos de tu hosting. La guía del Asistente de Instalación cubre exactamente cómo hacerlo paso a paso.
Email — Cualquier Proveedor SMTP
LeadHub puede enviar correos electrónicos (invitaciones, notificaciones de leads, correos de automatización, etc.) usando cualquier servicio de correo SMTP estándar.
NO configuras el correo durante la instalación. Después de que la instalación se complete, configuras el correo en el panel de administración en Configuración → Email. Ingresarás tu host SMTP, puerto, nombre de usuario y contraseña — todo lo cual te proporcionará tu proveedor de correo.
Proveedores de correo compatibles incluyen (pero no se limitan a):
- Gmail / Google Workspace
- Outlook / Microsoft 365
- Amazon SES
- Mailgun
- SendGrid
- Brevo (anteriormente Sendinblue)
- Postmark
- Cualquier otro servicio SMTP estándar
SSL / HTTPS
HTTPS es muy recomendado y prácticamente obligatorio para una instalación profesional. LeadHub maneja contraseñas, datos personales y credenciales de API — todo lo cual debería viajar por una conexión cifrada.
La mayoría de los proveedores de hosting ofrecen certificados SSL gratuitos a través de Let's Encrypt, que se pueden habilitar con un clic desde tu panel de cPanel o Plesk. Busca "SSL/TLS" o "Let's Encrypt" en tu panel de control. Habilítalo antes de comenzar la instalación para que tu URL de LeadHub use https:// desde el primer día.
Espacio en Disco
LeadHub en sí (todos los archivos de la aplicación, el directorio vendor/ y los assets compilados) ocupa aproximadamente 250 MB a 350 MB en disco. Recomendamos tener al menos 500 MB libres para acomodar cómodamente los archivos de la aplicación, tu base de datos, archivos subidos (logos, importaciones) y archivos de log.
RAM (Memoria)
LeadHub funciona cómodamente en planes típicos de hosting compartido. No necesitas preocuparte por la RAM en la mayoría de los planes. Como referencia:
- 512 MB RAM — mínimo, funciona bien para instalaciones pequeñas
- 1 GB RAM — cómodo para equipos de hasta 20 personas y volúmenes moderados de leads
- 2 GB+ RAM — recomendado para instalaciones de alto volumen con miles de leads por día
Si tu plan de hosting compartido especifica un límite de memoria PHP, LeadHub funciona bien con 256 MB por solicitud, que es el predeterminado en la mayoría de los hosts compartidos. Puedes verificar tu límite de memoria PHP en cPanel yendo a Select PHP Version y buscando memory_limit en la lista de opciones de PHP.
Lo Que NO Necesitas
Esto es importante saber desde el inicio. A diferencia de algunas plataformas, LeadHub está diseñado específicamente para funcionar sin nada de lo siguiente:
- Sin SSH / acceso a terminal — nunca necesitas iniciar sesión en tu servidor a través de línea de comandos
- Sin comandos artisan — no hay comandos
php artisanque ejecutar, nunca - Sin Composer — el directorio
vendor/con todas las dependencias ya está incluido en el paquete de descarga - Sin Node.js o npm — todos los assets de JavaScript y CSS están precompilados e incluidos en el paquete
- Sin Redis — LeadHub usa caché y sesiones basadas en archivos por defecto, lo cual funciona en cualquier host compartido
- Sin Supervisor — el procesamiento de trabajos en segundo plano y las tareas programadas se manejan completamente por
cron.php, que se ejecuta como un cron job estándar de hosting - Sin acceso root / administrador del servidor — los permisos de usuario estándar de hosting web son suficientes
Lista de Verificación Rápida
Usa esto antes de comenzar la instalación:
- PHP 8.3 o superior está activo para mi dominio
- Base de datos MySQL 8.0+ o MariaDB 10.4+ está disponible (cPanel la proporciona)
- Apache (con mod_rewrite) o Nginx es mi servidor web
- Tengo al menos 500 MB de espacio libre en disco
- Tengo un cliente FTP o puedo usar el Administrador de Archivos de cPanel para subir archivos
- Tengo una cuenta de correo SMTP lista (se puede configurar después de instalar)
- El certificado SSL está activo en mi dominio (muy recomendado)
Si todo está marcado, estás listo para instalar. Procede a la guía del Asistente de Instalación.