Saltar al contenido principal

📥 Instalación

PulseHub se instala a través de un asistente basado en navegador en dos pasos. No hay nada que compilar y no se requiere acceso por línea de comandos.

Paso 1 — Subir los Archivos​

  1. Descarga pulsehub-php.tar.gz y extráelo en tu máquina local. Obtendrás una carpeta llamada pulsehub-php/.
  2. Sube el contenido de esa carpeta (no la carpeta en sí) a tu raíz web. En la mayoría de los hosting compartidos es public_html/ o www/. En un VPS es donde apunte tu virtual host (ej. /var/www/pulsehub/).

Después de subir, tu raíz web debería verse así:

public_html/
├── index.php
├── .htaccess
├── cron.php
├── install/
├── app/
├── public/
├── config/        ← vacío en este punto, se crea durante la instalación
└── data/

Instalaciones en subdirectorio: Si quieres PulseHub en https://tudominio.com/soporte/ en lugar de la raíz, sube los archivos en public_html/soporte/. El archivo .htaccess maneja la ruta automáticamente.

Paso 2 — Ejecutar el Instalador de Base de Datos​

Abre tu navegador y navega a:

https://tudominio.com/install/

Instalador — Paso 1: Configuración de Base de Datos​

Completa tus credenciales de MySQL:

CampoDescripción
Host de Base de DatosGeneralmente localhost. En algunos hosts es una dirección IP — consulta la documentación de tu host.
PuertoEl predeterminado es 3306. Solo cámbialo si tu host usa un puerto no estándar.
Nombre de Base de DatosEl nombre de la base de datos que PulseHub debe usar. Se creará automáticamente si tu usuario MySQL tiene privilegio CREATE DATABASE.
Usuario de Base de DatosEl nombre de usuario MySQL que tiene acceso completo a la base de datos anterior.
Contraseña de Base de DatosLa contraseña para ese usuario.

Haz clic en Conectar y Crear Tablas →

Instalador — Paso 2: Cuenta de Administrador​

CampoDescripción
Nombre del Espacio de TrabajoEl nombre de tu organización, mostrado en la barra lateral.
Tu NombreEl nombre para mostrar del primer usuario administrador.
Dirección de EmailSe usa para iniciar sesión. Debe tener formato de email válido.
ContraseñaMínimo 8 caracteres. Se almacena como hash bcrypt — nunca en texto plano.
Confirmar ContraseñaDebe coincidir exactamente.

Haz clic en Crear Cuenta y Finalizar →

Paso 3 — Iniciar Sesión​

Haz clic en Ir a PulseHub → en la pantalla de éxito, o navega a https://tudominio.com/. Ingresa el email y la contraseña que acabas de crear.

Post-Instalación: Bloquear el Instalador​

El instalador se desactiva automáticamente una vez que existe config/database.php. Como precaución adicional, puedes eliminar el directorio install/ completamente después de la configuración usando el Administrador de Archivos de tu panel de hosting o tu cliente FTP.

Verificar una Instalación Exitosa​

Después de iniciar sesión deberías ver:

  • La barra lateral con Bandeja de Entrada, Contactos, Canales, Automatizaciones, Analíticas, Configuración
  • El nombre de tu espacio de trabajo y tu nombre en el pie de la barra lateral
  • La bandeja de entrada mostrando "Selecciona una conversación" (vacía — aún no hay mensajes)

Instalación con Nginx (Solo VPS — Omitir en Hosting Compartido)​

Usuarios de hosting compartido: Tu host ya maneja la configuración del servidor web. Esta sección es solo para VPS o servidores dedicados con Nginx. Puedes omitirla completamente.

Si estás ejecutando Nginx + PHP-FPM, copia la configuración de ejemplo proporcionada:

server {
    listen 80;
    server_name tudominio.com;
    root /var/www/pulsehub;
    index index.php;

    location ~ ^/(config|app|data)/ {
        deny all;
    }

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

Luego habilita el sitio y recarga Nginx (terminal del VPS):

sudo ln -s /etc/nginx/sites-available/pulsehub /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx