Guida e tutorial › Agenti LAN (rete interna) › Installazione agent (systemd / Docker)

Installazione agent (systemd / Docker)

4 min di lettura · Agenti LAN (rete interna)

In breve: l'installazione del LAN agent richiede tre minuti. Va come servizio systemd (Linux + root) o come container Docker (Synology, Unraid, k3s). All'agente serve solo HTTPS in uscita verso epulz.io.

1. Crea l'agente nella dashboard

  1. Apri Dashboard -> LAN agenti.
  2. Inserisci un nome sensato (ad es. "Azienda X - sala server", "Pi nel negozio di Bratislava").
  3. Premi Crea agente.
  4. Appare un token nel formato plzag_... - copialo subito. Viene mostrato una sola volta; se chiudi senza copiarlo dovrai creare un nuovo agente.

2a. Variante A - servizio systemd (Linux)

Per Raspberry Pi, mini PC, server virtuale o qualsiasi macchina Linux con accesso root:

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

Lo script:

  • Installa Python 3 e il binario ping (se mancano).
  • Scarica agent.py in /opt/epulzio-agent.
  • Scrive il token in /opt/epulzio-agent/agent.env con permessi 0600.
  • Registra e avvia il servizio systemd epulzio-agent.service.

Log dopo l'installazione: journalctl -u epulzio-agent -f

2b. Variante B - Docker

Per Synology / Unraid / k3s / TrueNAS / qualsiasi Docker host:

[Docker image v príprave]

--network host è fondamentale: l'agente deve accedere alla rete locale dell'host, non solo alla rete interna di Docker.

Dove conviene eseguire l'agente: una macchina sempre accesa con una buona connettività di rete verso i dispositivi che vuoi monitorare. Scelte classiche: Raspberry Pi in rete, mini PC nel rack, hypervisor host, NAS. Un singolo agente gestisce centinaia di monitor.

3. Verifica nella dashboard

In LAN agenti accanto all'agente compare lo stato:

  • online - l'agente invia heartbeat (contatto inferiore a 2 minuti)
  • timestamp - contatto negli ultimi 10 minuti
  • offline da ... - contatto più vecchio di 10 minuti (ricevi un'email dopo 5 min)

Aggiornamento dell'agente

Per la variante systemd:

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

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

Prossimo passo:

Creazione del primo monitor LAN (ping, TCP, HTTP).

Primo monitor LAN
Successivo →
Crea primo monitor LAN