Instalación

Esta guía cubre la instalación manual de Suricatavel con control completo sobre cada componente.

Para instalación rápida automatizada, consulta la Guía de Inicio Rápido.

Paso 1: Instalar PostgreSQL 18 y TimescaleDB

Debian / Ubuntu

1. Añadir repositorios

   # Añadir repositorio de PostgreSQL
    apt-get install -y gnupg2 wget lsb-release
    mkdir -p /usr/share/keyrings
   wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | gpg --dearmor -o /usr/share/keyrings/postgresql-archive-keyring.gpg
   echo "deb [signed-by=/usr/share/keyrings/postgresql-archive-keyring.gpg] http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" | tee /etc/apt/sources.list.d/pgdg.list
   
   # Añadir repositorio de TimescaleDB
   wget --quiet -O - https://packagecloud.io/timescale/timescaledb/gpgkey | gpg --dearmor -o /usr/share/keyrings/timescaledb-archive-keyring.gpg
   echo "deb [signed-by=/usr/share/keyrings/timescaledb-archive-keyring.gpg] https://packagecloud.io/timescale/timescaledb/ubuntu/ $(lsb_release -cs) main" | tee /etc/apt/sources.list.d/timescaledb.list

2. Instalar paquetes

    apt-get update
    apt-get install -y postgresql-18 postgresql-client-18 timescaledb-2-postgresql-18
   
   # Asegurar que el clúster PostgreSQL 18 existe (opcional si ya fue creado por la instalación)
   if ! pg_lsclusters | grep -q "18 main"; then
        pg_createcluster 18 main --start
   fi
   
   # Optimizar configuración de PostgreSQL
   # --quiet --yes ejecuta de forma no interactiva con la configuración recomendada
    timescaledb-tune --quiet --yes
   
    systemctl restart postgresql

3. Crear Base de Datos

   # Crear base de datos y usuario
    sudo -u postgres psql -c "CREATE USER suricatavel WITH PASSWORD 'tu-contraseña-segura';"
    sudo -u postgres psql -c "CREATE DATABASE suricataveldb OWNER suricatavel;"

RHEL / Rocky / AlmaLinux

1. Añadir repositorios

   # Añadir repositorio de PostgreSQL
    dnf install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-9-x86_64/pgdg-redhat-repo-latest.noarch.rpm
   
   # Deshabilitar módulo postgresql nativo
    dnf -qy module disable postgresql
   
   # Añadir repositorio de TimescaleDB (usando el/9 para compatibilidad)
    tee /etc/yum.repos.d/timescale_timescaledb.repo <<EOF
   [timescale_timescaledb]
   name=TimescaleDB
   baseurl=https://packagecloud.io/timescale/timescaledb/el/9/\$basearch
   enabled=1
   gpgcheck=1
   repo_gpgcheck=1
   gpgkey=https://packagecloud.io/timescale/timescaledb/gpgkey
   EOF

2. Instalar y Configurar

   # Instalar PostgreSQL 18 y TimescaleDB
    dnf install -y postgresql18-server postgresql18 timescaledb-2-postgresql-18
   
   # Inicializar base de datos
    /usr/pgsql-18/bin/postgresql-18-setup initdb
   
   # Iniciar y habilitar servicio para que timescaledb-tune pueda conectar
    systemctl enable --now postgresql-18
   
   # Optimizar configuración de PostgreSQL
   # --quiet --yes ejecuta de forma no interactiva con la configuración recomendada
    timescaledb-tune --quiet --yes
   
   # Reiniciar para aplicar cambios
    systemctl restart postgresql-18

3. Crear Base de Datos

   # Crear base de datos y usuario
    sudo -u postgres psql -c "CREATE USER suricatavel WITH PASSWORD 'tu-contraseña-segura';"
    sudo -u postgres psql -c "CREATE DATABASE suricataveldb OWNER suricatavel;"

Paso 2: Instalar PHP (8.4 u 8.5)

Ubuntu

# Añadir repositorio PPA de Ondřej Surý
 apt install -y lsb-release ca-certificates apt-transport-https software-properties-common
 add-apt-repository ppa:ondrej/php -y
 apt update

# Instalar PHP 8.4 y extensiones
 apt install -y php8.4-cli \
    php8.4-pgsql php8.4-pdo \
    php8.4-mbstring php8.4-xml php8.4-curl \
    php8.4-zip php8.4-bcmath php8.4-intl \
    php8.4-redis php8.4-opcache

# Opcional: Extensión de Kafka (solo si usas transporte Kafka)
 apt install -y php8.4-rdkafka

Debian

# Añadir repositorio DPA de Ondřej Surý
 apt install -y lsb-release ca-certificates apt-transport-https software-properties-common curl
curl -sSLo /usr/share/keyrings/deb.sury.org-php.gpg https://packages.sury.org/php/apt.gpg
 sh -c 'echo "deb [signed-by=/usr/share/keyrings/deb.sury.org-php.gpg] https://packages.sury.org/php/ $(lsb_release -sc) main" > /etc/apt/sources.list.d/php.list'
 apt update

# Instalar PHP 8.4 y extensiones
 apt install -y php8.4-cli \
    php8.4-pgsql php8.4-pdo \
    php8.4-mbstring php8.4-xml php8.4-curl \
    php8.4-zip php8.4-bcmath php8.4-intl \
    php8.4-redis php8.4-opcache

# Opcional: Extensión de Kafka (solo si usas transporte Kafka)
 apt install -y php8.4-rdkafka

RHEL / Rocky / AlmaLinux

# Añadir repositorio Remi
 dnf install -y epel-release
 dnf install -y https://rpms.remirepo.net/enterprise/remi-release-9.rpm

# Habilitar PHP 8.4
 dnf module reset php -y
 dnf module enable php:remi-8.4 -y

# Instalar PHP 8.4 y extensiones
 dnf install -y php php-cli \
    php-pgsql php-pdo \
    php-mbstring php-xml php-curl \
    php-zip php-bcmath php-intl \
    php-redis php-opcache php-process \
    php-pecl-swoole

# Opcional: Extensión de Kafka (solo si usas transporte Kafka)
 dnf install -y php-pecl-rdkafka

Verificar instalación de PHP:

php -v
php -m | grep -E "pdo|pgsql|pcntl|posix"

Paso 3: Instalar Nginx

Debian / Ubuntu

 apt install -y nginx

RHEL / Rocky / AlmaLinux

 dnf install -y nginx

Configurar Nginx para Suricatavel:

Crear /etc/nginx/sites-available/suricatavel (o conf.d/suricatavel.conf en RHEL):

server {
    listen 80;
    listen [::]:80;
    server_name tu-dominio.com;
    root /var/opt/suricatavel/public;

    index index.php;
    error_page 404 /index.php;

    # Aplicación principal mediante Octane (Swoole)
    location / {
        proxy_pass http://127.0.0.1:8089;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_set_header Scheme $scheme;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }

    # Reverb WebSocket server
    location /apps/ {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }

    location ~ /\.(?!well-known).* {
        deny all;
    }
}

Habilitar el sitio:

Debian / Ubuntu

 ln -s /etc/nginx/sites-available/suricatavel /etc/nginx/sites-enabled/
 nginx -t
 systemctl restart nginx

RHEL / Rocky / AlmaLinux

 nginx -t
 systemctl restart nginx

Paso 4: Instalar Supervisor

Debian / Ubuntu

 apt install -y supervisor
 systemctl enable --now supervisor

RHEL / Rocky / AlmaLinux

 dnf install -y supervisor
 systemctl enable --now supervisord

Paso 5: Configurar repositorio de Suricatavel

Debian / Ubuntu

# Importar clave GPG
curl -fsSL https://suricatavel.org/suricatavel.gpg | gpg --dearmor -o /etc/apt/keyrings/suricatavel.gpg

# Añadir repositorio
echo "deb [signed-by=/etc/apt/keyrings/suricatavel.gpg] https://repository.suricatavel.org stable main" | tee /etc/apt/sources.list.d/suricatavel.list > /dev/null

# Actualizar caché de paquetes
 apt update

RHEL / Rocky / AlmaLinux

# Crear archivo de repositorio
 tee /etc/yum.repos.d/suricatavel.repo > /dev/null << 'EOF'
[suricatavel]
name=Repositorio Suricatavel
baseurl=https://repository.suricatavel.org/rpm/stable/
enabled=1
gpgcheck=1
gpgkey=https://suricatavel.org/suricatavel.gpg
EOF

# Actualizar caché
 dnf makecache

Paso 6: Instalar paquete Suricatavel

Debian / Ubuntu

 apt install -y suricatavel

RHEL / Rocky / AlmaLinux

 dnf install -y suricatavel

Lo que hace el paquete:

1. Crea usuario del sistema suricatavel (sin shell de login)
2. Instala archivos de aplicación en /var/opt/suricatavel
3. Crea directorios de trabajo con permisos adecuados
4. Genera APP_KEY para Laravel
5. Ejecuta migraciones de base de datos (si la BD está accesible)
6. Configura workers de Supervisor
7. Construye cachés de Laravel

Paso 7: Configurar la aplicación

Edita el archivo de entorno:

 nano /var/opt/suricatavel/.env

Configuración esencial:

APP_NAME=Suricatavel
APP_ENV=production
APP_DEBUG=false
APP_URL=http://tu-dominio.com

DB_CONNECTION=pgsql
DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=suricatavel
DB_USERNAME=suricatavel
DB_PASSWORD=tu-contraseña-segura

# Opcional: Configuración de Kafka (Alto rendimiento)
#KAFKA_BROKERS=localhost:9092
#KAFKA_CONSUMER_GROUP_ID=suricatavel

# Opcional: Configuración HTTP (Setup simple)
#SURICATAVEL_AGENT_TRANSPORT=http
#SURICATAVEL_AGENT_HTTP_ENDPOINT=http://tu-dominio.com/api/v1/events
#SURICATAVEL_AGENT_HTTP_TOKEN=tu-token-agente

# Opcional: Redis para caché
REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379

# Configuración de correo
MAIL_MAILER=smtp
MAIL_HOST=smtp.example.com
MAIL_PORT=587
MAIL_USERNAME=[email protected]
MAIL_PASSWORD=tu-contraseña-smtp
MAIL_ENCRYPTION=tls

Si la base de datos no estaba accesible durante la instalación, ejecuta las migraciones manualmente:

 suricatavel deploy --migrate

Reconstruye las cachés después de cambios de configuración:

suricatavel maintenance cache

Paso 8: Verificar workers

El paquete suricatavel configura automáticamente Supervisor. Verifica el estado:

suricatavel status

Deberías ver procesos como web, worker, scheduler en estado RUNNING. Si Kafka está habilitado, también deberías ver kafka.

Post-instalación

Inicializar Suricatavel

Inicializa la aplicación:

suricatavel boot

O en modo no interactivo (crea usuario admin predeterminado):

suricatavel boot -s

Credenciales predeterminadas:

• Email: [email protected]
• Contraseña: 123456

Seguridad

¡Cambia la contraseña inmediatamente tras el primer inicio de sesión!

Verificar instalación

# Verificar estado del sistema
suricatavel status

# Verificar versión de la aplicación
suricatavel version

Seguridad

1. Habilitar HTTPS

Instalar Certbot:

Debian / Ubuntu

 apt install -y certbot python3-certbot-nginx

RHEL / Rocky / AlmaLinux

 dnf install -y certbot python3-certbot-nginx

Obtener certificado SSL:

 certbot --nginx -d tu-dominio.com

2. Configurar firewall

Debian / Ubuntu

 ufw allow 22/tcp
 ufw allow 80/tcp
 ufw allow 443/tcp
 ufw enable

RHEL / Rocky / AlmaLinux

 firewall-cmd --permanent --add-service=ssh
 firewall-cmd --permanent --add-service=http
 firewall-cmd --permanent --add-service=https
 firewall-cmd --reload

3. Establecer permisos adecuados

 chown -R suricatavel:suricatavel /var/opt/suricatavel
 chmod -R 755 /var/opt/suricatavel
 chmod -R 775 /var/opt/suricatavel/storage
 chmod -R 775 /var/opt/suricatavel/bootstrap/cache

4. Deshabilitar modo debug

Asegurar en /var/opt/suricatavel/.env:

APP_DEBUG=false
APP_ENV=production

Actualizar Suricatavel

Para actualizaciones sin tiempo de inactividad con rollback automático, usa el CLI:

suricatavel update

El comando de actualización gestionará backup, modo mantenimiento, actualización de paquetes y migraciones automáticamente.

Para actualizaciones manuales vía gestor de paquetes:

Debian / Ubuntu

apt update
apt upgrade suricatavel

RHEL / Rocky / AlmaLinux

dnf upgrade suricatavel

Solución de problemas

Ver la Guía de Inicio Rápido para problemas comunes.

Próximos pasos

• Configurar agentes para enviar eventos
• Desplegar reglas IDS para detección
• Configurar notificaciones para alertas
• Configurar feeds para inteligencia de amenazas
• Revisar opciones de configuración

Para preguntas o problemas, consulta las FAQ o contribuye.