Agente para Linux Debian / Ubuntu

Cómo instalar y verificar el agente NESS HQ en un equipo con Debian 12+ o Ubuntu 22.04+ (incluye derivados: Kubuntu, Xubuntu, Pop!_OS, Linux Mint).

1. ¿Qué se instala en mi Linux?

Al instalar el agente, el equipo queda protegido y monitoreado por NESS HQ. El instalador:

• Copia los binarios del agente a una carpeta del sistema.
• Crea servicios (que se inician automáticamente con el sistema).
• Configura la extensión del navegador para DLP.
• No agrega íconos visibles al usuario.

2. Requisitos

Requisito	Detalle
Distribución	Debian 12 o superior, Ubuntu 22.04 LTS o superior.
Permisos	Usuario con acceso a sudo (administrador).
Red	Acceso HTTPS (puerto 443) hacia cloud.nesshq.com.
RAM	1 GB mínimo libre (el agente consume menos de 100 MB).
Disco	2 GB libres. Ver requisitos: disco por confirmar.

3. Instalación paso a paso

3.1 Método rápido (recomendado)

1. Abre una Terminal (suele estar en Aplicaciones o búscala con Ctrl + Alt + T).

2. Copia y pega este comando (reemplaza TU_TOKEN por el token que te dio el administrador):

   curl -fsSL https://storage.googleapis.com/repo.nesshq.com/scripts/install.sh \
     | NESS_TOKEN='TU_TOKEN' NESS_TIME='15' sudo -E bash

3. Te pedirá tu contraseña de sudo. Escríbela y presiona Enter. (Al escribir la contraseña no se ven caracteres; es normal.)

4. Verás el logo NESS y una lista de pasos con marcas verdes al completarse.

5. Al final debe decir "INSTALADO" o un mensaje de éxito.

Captura pendiente: 01 - Comando de instalación

Imagen pendiente de incorporar.

Captura pendiente: 02 - Instalación exitosa

Imagen pendiente de incorporar.

3.2 Método con instalador descargado

Si no tienes buena conexión o quieres instalar desde un archivo local:

1. Pide al administrador el archivo install.sh.

2. Cópialo al equipo.

3. Abre la Terminal.

4. Ejecuta:

   chmod +x install.sh
   sudo ./install.sh --token "TU_TOKEN"

3.3 Parámetros que puedes usar

Parámetro	Para qué sirve	Ejemplo
--token "<TOKEN>" (o -t)	Token de tu organización (obligatorio).	--token "<TOKEN>"
--time 15 (o -i)	Cada cuántos minutos el agente reporta. Valores: 5, 15, 30 o 60. Default: 15.	--time 30
--services "nginx,mysql" (o -s)	Servicios adicionales a monitorear, separados por coma.	--services "nginx,postgresql,ssh"
--silent	No muestra el banner (para Ansible, Puppet, etc.).	--silent
--help (o -h)	Muestra la ayuda.	--help

Variables de entorno equivalentes:

export NESS_TOKEN="<TOKEN>"
export NESS_TIME="15"
export NESS_SERVICES="nginx,postgresql"
sudo -E ./install.sh

4. Distribuciones compatibles

Distribución	Versiones	Notas
Debian	12 (bookworm), 13 (trixie)	Soporte oficial.
Ubuntu	22.04 LTS, 24.04 LTS, 24.10	Soporte oficial.
Pop!_OS	22.04+	(basado en Ubuntu).
Linux Mint	21+	(basado en Ubuntu).
KDE Neon	22.04+	(basado en Ubuntu).

Para otras familias Linux, consulta:

• Linux RHEL/Fedora/Rocky →
• Linux SUSE →
• Linux ARM64 →

5. ¿Cómo verifico que está funcionando?

5.1 Desde el portal NESS HQ

1. Entra a https://cloud.nesshq.com.
2. Ve a Hosts o Inventario.
3. Busca tu equipo por nombre.
4. Debe aparecer con un punto verde verde.

Captura pendiente: 03 - Equipo en línea en el portal

Imagen pendiente de incorporar.

5.2 Desde la Terminal

Abre una Terminal y ejecuta:

sudo ness-core-service --doctor

Verás un reporte con varias verificaciones. Todas deben decir OK.

Captura pendiente: 04 - Diagnóstico doctor

Imagen pendiente de incorporar.

5.3 Ver los registros (logs)

sudo journalctl -u ness-core -n 100 --no-pager

Para ver en vivo:

sudo journalctl -u ness-core -f

(Presiona Ctrl + C para dejar de verlos.)

Captura pendiente: 05 - Registros con journalctl

Imagen pendiente de incorporar.

6. ¿Qué hago si algo falla?

Síntoma	Causa probable	Solución
"Permission denied" al instalar	No usaste sudo	Vuelve a ejecutar con sudo.
"Connection refused" durante la instalación	Sin conexión de red	Verifica la conexión a cloud.nesshq.com.
El equipo no aparece en el portal	Aún no pasaron 5 minutos	Espera unos minutos y refresca la página.
El portal dice que el equipo está Offline	Sin red, equipo apagado, o el servicio se detuvo	Verifica la red y ejecuta sudo systemctl status ness-core.
La instalación falla por paquetes	Repositorios desactualizados	Ejecuta sudo apt update && sudo apt upgrade y vuelve a intentar.

Si el problema persiste, contacta al administrador de tu cuenta NESS.

7. ¿Cómo actualizo el agente?

No tienes que hacer nada. Las actualizaciones se descargan e instalan automáticamente (suele ser una vez al día).

Si quieres forzar una actualización:

sudo ness-updater --update

8. ¿Cómo desinstalo el agente?

8.1 Desde el portal (recomendado)

Pide al administrador que desinstale el agente remotamente:

1. Hosts → selecciona tu equipo.
2. Acciones → Desinstalar agente.

Captura pendiente: 06 - Desinstalar desde el portal

Imagen pendiente de incorporar.

8.2 Desde la Terminal

sudo /usr/local/bin/uninstall.sh

9. Soporte

• Web: https://nesshq.com
• Email: soporte@nesshq.com

Ruta completa

El instalador agrega los binarios de NESS al PATH, así que los comandos se usan por su nombre. También puedes usar la ruta completa, p. ej. & "C:\Program Files\NESS Core\ness-updater.exe" --update

Fuente

Guías para el cliente NESS HQ (2026). Ver Fuentes.