SecuryBlack LogoSecuryBlack

Instalación

Guía paso a paso para instalar SecuryBlack en tu VPS.

Requisitos previos

  • ✓ Un VPS o servidor dedicado con Linux (Ubuntu, Debian, CentOS, Fedora, etc.)
  • ✓ Acceso SSH a tu servidor
  • ✓ Conexión a internet (para descargar el agente)
  • ✓ Una cuenta activa en SecuryBlack (plan gratuito Hobby disponible)

Plataformas soportadas

Linux

  • • Ubuntu 20.04+
  • • Debian 11+
  • • CentOS/RHEL 8+
  • • Fedora 35+
  • • Arch Linux

Windows

  • • Windows Server 2019+
  • • Windows 10/11
  • • PowerShell 5.0+

Arquitecturas

  • • x86_64 (AMD64)
  • • ARM64 (aarch64)
  • • ARMv7 (32-bit)

Instalación

Elige el comando correspondiente a tu sistema operativo:

Linux / macOS

Conéctate a tu servidor por SSH e instala el agente con este comando:

curl -fsSL https://install.securyblack.com/linux | bash

El instalador detectará automáticamente tu arquitectura y descargará el binario correcto. Se instala como servicio systemd y se inicia automáticamente.

Windows (PowerShell)

Abre PowerShell como administrador e instala con este comando:

irm https://install.securyblack.com/windows | iex

El instalador se descargará automáticamente y se instalará como servicio de Windows. Se inicia automáticamente en el siguiente reinicio.

Instalación manual (OTLP)

Si prefieres no usar el instalador anterior, puedes configurar el agente OxiPulse manualmente apuntando al endpoint OTLP de tu cuenta.

Endpoint OTLP

ingest.securyblack.com

Puerto 443 (HTTPS/gRPC). El token del servidor va en la cabecera Authorization: Bearer.

Linux / macOS

Ejecuta como root o con sudo. El script pedirá el endpoint y el token de forma interactiva:

curl -fsSL https://install.oxipulse.dev | bash

Windows (PowerShell)

Ejecuta en PowerShell como Administrador. El script pedirá el endpoint y el token de forma interactiva:

irm https://install.oxipulse.dev | iex

El token del servidor se muestra una única vez al crearlo. Si lo pierdes, genera uno nuevo desde la página de detalles del servidor en tu dashboard.

Verificar instalación

Después de la instalación, verifica que el agente está corriendo:

Linux / macOS

Comprueba el estado del servicio:

systemctl status oxipulse

Revisa los logs:

journalctl -u oxipulse -f

Windows (PowerShell)

Comprueba el estado del servicio:

Get-Service OxiPulse

Revisa los logs (Visor de eventos):

Get-EventLog -LogName Application -Source OxiPulse -Newest 20

Configuración

El archivo de configuración está en /etc/securyblack/oxipulse.yaml.

Para la mayoría de casos, la configuración por defecto es suficiente. El agente se conectará automáticamente al endpoint de SecuryBlack configurado durante la instalación.

Desinstalar

Si necesitas desinstalar OxiPulse:

Linux / macOS

sudo systemctl stop oxipulse && sudo rm /usr/local/bin/oxipulse

Windows (PowerShell)

Stop-Service OxiPulse; Remove-Item -Path "C:\Program Files\OxiPulse" -Recurse -Force

Solución de problemas

El agente no se conecta

Verifica que tu servidor tiene conexión a internet y que el endpoint está configurado correctamente.

  • Linux/macOS: /etc/securyblack/oxipulse.yaml
  • Windows: C:\Program Files\OxiPulse\config.yaml

Consumo alto de CPU

En idle, OxiPulse debe consumir menos del 1% de CPU. Si consume más, revisa los logs.

  • Linux/macOS: journalctl -u oxipulse -f
  • Windows: Get-EventLog -LogName Application -Source OxiPulse

¿Aún tienes problemas?

Contacta con nosotros en support o abre un issue en GitHub.