# Instalación

Argus se instala en el servidor cuyos registros lee, no en el ordenador donde mira los gráficos. El paquete es un archivo Debian, independiente de la arquitectura, instalado con `apt` en Debian o Ubuntu. El procedimiento completo está en la guía de instalación del repositorio.

## Descargar e instalar

Descargue `argus_1.0.0-14_all.deb` de la página de versiones del [repositorio](https://github.com/RonanDavalan/Argus) y luego ejecute este comando en el servidor:

```bash
sudo apt install ./argus_1.0.0-14_all.deb
```


`apt` instala las dos dependencias declaradas, `gawk` y `gnuplot-nox`. Tres tareas entran en el archivo cron: la recogida a las 00:05, los gráficos a las 00:15 y la comprobación de estado a las 00:20. La primera imagen se escribe la noche siguiente en `/srv/argus/<year>/images/`.

Un servidor que ya tiene historial de registros puede producir sus primeros archivos enseguida, a mano:

```bash
sudo /opt/argus/collect-ssh.sh
sudo /opt/argus/chart-daily.sh
ls /srv/argus/2026/images/
```


## Qué instala el paquete

- los recolectores y los scripts de gráficos en `/opt/argus/`;
- los comandos `argus-chart` y `argus-fetch` en `/usr/bin/`;
- los ajustes opcionales en `/etc/argus/argus.conf`, todas las líneas comentadas;
- las tareas nocturnas en `/etc/cron.d/argus`;
- los datos y las imágenes en `/srv/argus/`, legibles por cualquier usuario porque solo contienen recuentos.

El directorio de datos conserva un archivo por serie y por año, con una línea por hora que vio un ataque. Nada en él es una dirección IP.

## Comprobar la recogida

`argus-doctor.sh` informa de la última recogida correcta de cada fuente:

```bash
sudo /opt/argus/argus-doctor.sh
```


Un gráfico vacío tiene dos causas posibles: un día sin ataques o un recolector que ya no se ejecuta. El latido que deja cada recolector permite distinguirlos. La [guía de solución de problemas](https://github.com/RonanDavalan/Argus/blob/main/docs/troubleshooting.md) da el significado de cada línea.

## Cambiar un ajuste

`/etc/argus/argus.conf` es un archivo de shell que lee cada script. Descomente solo lo que necesite:

```bash
# /etc/argus/argus.conf
ARGUS_SSH_THRESHOLD=10            # fallos por IP y día
ARGUS_LANG=en                     # idioma de los gráficos
ARGUS_IMG_WIDTH=3840              # tamaño en píxeles
ARGUS_IMG_HEIGHT=2160
ARGUS_COULEUR_ssh_direct=orange   # color de una serie
```


Todas las variables se enumeran en `man argus`.

## Desinstalación

```bash
sudo apt remove argus     # conserva /srv/argus y /etc/argus
sudo apt purge argus      # también los elimina
```


La purga también borra el historial, así que copie las imágenes al equipo de escritorio antes de ejecutarla. El procedimiento completo, la estructura de archivos y los ajustes están en [docs/install.md](https://github.com/RonanDavalan/Argus/blob/main/docs/install.md).