SecuryBlack

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 install.securyblack.com | 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 install.securyblack.com | iex

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

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.