# Installation

Argus s'installe sur le serveur dont il lit les journaux, pas sur l'ordinateur où vous regardez les graphiques. Le paquet est une archive Debian, indépendante de l'architecture, installée avec `apt` sur Debian ou Ubuntu. La procédure complète se trouve dans le guide d'installation du dépôt.

## Télécharger et installer

Téléchargez `argus_1.0.0-14_all.deb` depuis la page des versions du [dépôt](https://github.com/RonanDavalan/Argus), puis exécutez cette commande sur le serveur :

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


`apt` installe les deux dépendances déclarées, `gawk` et `gnuplot-nox`. Trois tâches entrent dans le fichier cron : la collecte à 00:05, les graphiques à 00:15 et le contrôle de santé à 00:20. La première image est écrite la nuit suivante dans `/srv/argus/<year>/images/`.

Un serveur qui possède déjà un historique de journaux peut produire ses premiers fichiers tout de suite, à la main :

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


## Ce que le paquet installe

- les collecteurs et les scripts de graphiques dans `/opt/argus/` ;
- les commandes `argus-chart` et `argus-fetch` dans `/usr/bin/` ;
- les réglages facultatifs dans `/etc/argus/argus.conf`, chaque ligne commentée ;
- les tâches nocturnes dans `/etc/cron.d/argus` ;
- les données et les images dans `/srv/argus/`, lisibles par tous les utilisateurs parce qu'elles ne contiennent que des comptes.

Le répertoire de données conserve un fichier par série et par année, avec une ligne par heure ayant vu une attaque. Rien n'y est une adresse IP.

## Contrôler la collecte

`argus-doctor.sh` signale la dernière collecte réussie de chaque source :

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


Un graphique vide a deux causes possibles : une journée sans attaque, ou un collecteur qui ne s'exécute plus. Le battement de vie laissé par chaque collecteur permet de les distinguer. Le [guide de dépannage](https://github.com/RonanDavalan/Argus/blob/main/docs/troubleshooting.md) donne la signification de chaque ligne.

## Changer un réglage

`/etc/argus/argus.conf` est un fichier shell lu par chaque script. Décommentez seulement ce dont vous avez besoin :

```bash
# /etc/argus/argus.conf
ARGUS_SSH_THRESHOLD=10            # échecs par IP et par jour
ARGUS_LANG=en                     # langue des graphiques
ARGUS_IMG_WIDTH=3840              # taille en pixels
ARGUS_IMG_HEIGHT=2160
ARGUS_COULEUR_ssh_direct=orange   # couleur d'une série
```


Toutes les variables sont listées dans `man argus`.

## Désinstallation

```bash
sudo apt remove argus     # garde /srv/argus et /etc/argus
sudo apt purge argus      # les supprime aussi
```


La purge supprime aussi l'historique, copiez donc les images sur le poste de bureau avant de la lancer. La procédure complète, l'arborescence des fichiers et les réglages sont dans [docs/install.md](https://github.com/RonanDavalan/Argus/blob/main/docs/install.md).