Instalación

CaudalGhost se distribuye como dos paquetes .deb para Debian/Ubuntu (amd64). Elige según tu equipo. No hace falta correo, cuenta ni registro.

Requisitos

Distribución: Debian/Ubuntu 22.04 o superior (o derivada: Kubuntu, etc.).
Arquitectura: amd64 (x86-64).
Kernel con eBPF: prácticamente cualquier kernel reciente de escritorio o servidor bare-metal. En VPS de contenedor, el host puede bloquear eBPF.

Edición Escritorio (.deb con GUI)

Para tu Linux de escritorio (Kubuntu, CachyOS…). Incluye daemon + CLI + GUI.

sudo dpkg -i caudalghost_0.3.0-1_amd64.deb

Si dpkg se queja de dependencias (WebKit/GTK), resuélvelas con:

sudo apt-get install -f

Tras instalar, el daemon arranca como servicio y la GUI aparece en el menú de aplicaciones. No necesitas cerrar sesión.

Edición Server headless (.deb)

Para tu servidor o homelab (Ubuntu Server bare-metal). Incluye solo daemon + CLI (sin gráficas).

sudo dpkg -i caudalghost-server_0.3.0-1_amd64.deb

Esta edición sustituye a la de escritorio si ya la tuvieras instalada (declara Conflicts/Replaces).

Permisos: por qué pide privilegios al instalar (y por qué luego NO)

La instalación se hace con privilegios (sudo) porque registra el servicio del sistema, crea el usuario caudalghost y aplica una regla de permisos. Pero en el uso diario NO necesitas sudo: el daemon corre como servicio con las capacidades justas (lectura de eBPF) y te concede acceso al socket automáticamente. Ver Permisos para el detalle.

Verificar la descarga

Antes de instalar, comprueba que el .deb no se corrompió ni fue manipulado. Cada release publica el SHA-256 de cada paquete.

# Calcula el hash del archivo descargado:
sha256sum caudalghost_0.3.0-1_amd64.deb

Compara la salida con el valor publicado en la página de descargas / en GitHub Releases. Si coincide, el archivo es íntegro. Para verificar automáticamente contra un fichero de sumas:

# Con un archivo SHA256SUMS junto a los .deb:
sha256sum -c SHA256SUMS

Debe imprimir caudalghost_0.3.0-1_amd64.deb: OK.

Actualizar

Para actualizar, instala el .deb nuevo con sudo dpkg -i …. El proceso reinicia el daemon y conserva tu base de datos en /var/lib/caudalghost.

Desinstalar

# Quita el paquete (conserva la base de datos):
sudo apt-get remove caudalghost        # o caudalghost-server

# Quita el paquete Y su configuración:
sudo apt-get purge caudalghost

Para borrar también el histórico, ver cómo borrar tus datos.