Agent-Installation (systemd / Docker)

4 Min. Lesezeit · LAN-Agenten (internes Netz)

Kurz gesagt: Die Installation des LAN-Agenten dauert drei Minuten. Entweder als systemd-Dienst (Linux + root) oder als Docker-Container (Synology, Unraid, k3s). Der Agent benötigt nur ausgehendes HTTPS zu epulz.io.

1. Agent im Dashboard erstellen

Öffnen Sie Dashboard -> LAN-Agenten.
Geben Sie einen sinnvollen Namen ein (z. B. "Firma X - Serverraum", "Pi im Geschäft Bratislava").
Drücken Sie Agent erstellen.
Es wird ein Token im Format plzag_… angezeigt - kopieren Sie es sofort. Es wird nur einmal angezeigt; wenn Sie es schließen, ohne zu kopieren, müssen Sie einen neuen Agenten erstellen.

2a. Variante A - systemd-Dienst (Linux)

Für Raspberry Pi, Mini-PC, virtuellen Server oder jeden Linux-Rechner mit Root-Zugriff:

sudo bash <(curl -s https://epulz.io/install-agent.sh) plzag_IHR_TOKEN

Das Skript:

Installiert Python 3 und die Binary ping (falls fehlend).
Lädt agent.py nach /opt/epulzio-agent herunter.
Schreibt das Token in /opt/epulzio-agent/agent.env mit Permissions 0600.
Registriert und startet den systemd-Dienst epulzio-agent.service.

Logs nach der Installation: journalctl -u epulzio-agent -f

2b. Variante B - Docker

Für Synology / Unraid / k3s / TrueNAS / jeden Docker-Host:

[Docker image v príprave]

--network host ist entscheidend: Der Agent muss auf das lokale Netzwerk des Hosts zugreifen können, nicht nur auf das interne Docker-Netzwerk.

Wo der Agent am besten ausgeführt wird: Ein Rechner, der immer eingeschaltet ist und eine gute Netzwerkverbindung zu den Geräten hat, die Sie überwachen möchten. Klassische Optionen: Raspberry Pi im Netzwerk, Mini-PC im Rack, Hypervisor-Host, NAS. Ein Agent bewältigt Hunderte von Monitoren.

3. Im Dashboard überprüfen

In LAN-Agenten wird neben dem Agenten der Status angezeigt:

online - der Agent sendet Heartbeat (Kontakt jünger als 2 Minuten)
Zeitstempel - Kontakt in den letzten 10 Minuten
offline seit … - Kontakt älter als 10 Minuten (Sie erhalten eine E-Mail nach 5 Min.)

Agent-Aktualisierung

Für die systemd-Variante:

sudo curl -sfL https://epulz.io/static/agent/epulzio-agent.py -o /opt/epulzio-agent/agent.py
sudo systemctl restart epulzio-agent

Für Docker: # Docker image v príprave - použite systemd inštaláciu nižšie


  Nächster Schritt:
  Erstellung des ersten LAN-Monitors (Ping, TCP, HTTP).
  Erster LAN-Monitor