# Installation

Argus wird auf dem Server installiert, dessen Protokolle es liest, nicht auf dem Computer, an dem Sie die Diagramme betrachten. Das Paket ist ein Debian-Archiv, architekturunabhängig, mit `apt` auf Debian oder Ubuntu installiert. Die vollständige Prozedur steht im Installationsleitfaden des Repositorys.

## Herunterladen und installieren

Laden Sie `argus_1.0.0-14_all.deb` von der Release-Seite des [Repositorys](https://github.com/RonanDavalan/Argus) herunter und führen Sie dann diesen Befehl auf dem Server aus:

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


`apt` installiert die beiden deklarierten Abhängigkeiten `gawk` und `gnuplot-nox`. Drei Jobs gelangen in die Cron-Datei: die Sammlung um 00:05, die Diagramme um 00:15 und die Gesundheitsprüfung um 00:20. Das erste Bild wird in der folgenden Nacht in `/srv/argus/<year>/images/` geschrieben.

Ein Server, der bereits einen Protokollverlauf besitzt, kann seine ersten Dateien sofort von Hand erzeugen:

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


## Was das Paket installiert

- die Sammler und Diagrammskripte in `/opt/argus/`;
- die Befehle `argus-chart` und `argus-fetch` in `/usr/bin/`;
- die optionalen Einstellungen in `/etc/argus/argus.conf`, jede Zeile auskommentiert;
- die nächtlichen Jobs in `/etc/cron.d/argus`;
- die Daten und die Bilder in `/srv/argus/`, für jeden Benutzer lesbar, weil sie nur Anzahlen enthalten.

Das Datenverzeichnis hält eine Datei pro Serie und pro Jahr, mit einer Zeile pro Stunde, in der ein Angriff gesehen wurde. Nichts darin ist eine IP-Adresse.

## Die Sammlung prüfen

`argus-doctor.sh` meldet die letzte erfolgreiche Sammlung jeder Quelle:

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


Ein leeres Diagramm hat zwei mögliche Ursachen: einen Tag ohne Angriffe oder einen Sammler, der nicht mehr läuft. Das von jedem Sammler hinterlassene Lebenszeichen trennt beide. Der [Leitfaden zur Fehlerbehebung](https://github.com/RonanDavalan/Argus/blob/main/docs/troubleshooting.md) gibt die Bedeutung jeder Zeile.

## Eine Einstellung ändern

`/etc/argus/argus.conf` ist eine Shell-Datei, die von jedem Skript gelesen wird. Entfernen Sie die Kommentarzeichen nur bei dem, was Sie brauchen:

```bash
# /etc/argus/argus.conf
ARGUS_SSH_THRESHOLD=10            # Fehlversuche je IP und Tag
ARGUS_LANG=en                     # Sprache der Diagramme
ARGUS_IMG_WIDTH=3840              # Größe in Pixeln
ARGUS_IMG_HEIGHT=2160
ARGUS_COULEUR_ssh_direct=orange   # Farbe einer Serie
```


Alle Variablen sind in `man argus` aufgeführt.

## Entfernen

```bash
sudo apt remove argus     # behält /srv/argus und /etc/argus
sudo apt purge argus      # löscht beide auch
```


Purge löscht auch den Verlauf, kopieren Sie die Bilder also vorher auf den Arbeitsplatzrechner. Die vollständige Prozedur, der Dateiaufbau und die Einstellungen stehen in [docs/install.md](https://github.com/RonanDavalan/Argus/blob/main/docs/install.md).