Inštalácia agenta (systemd / Docker)

4 min čítania · LAN agenti (interná sieť)

V skratke: Inštalácia LAN agenta trvá tri minúty. Buď ako systemd služba (Linux + root), alebo ako Docker kontajner (Synology, Unraid, k3s). Agent potrebuje len odchádzajúci HTTPS na epulz.io.

1. Vytvorte agenta v dashboarde

Otvorte Dashboard → LAN agenti.
Zadajte rozumný názov (napr. „Firma X - serverovňa", „Pi v predajni Bratislava").
Stlačte Vytvoriť agenta.
Zobrazí sa token vo formáte plzag_… - skopírujte ho ihneď. Zobrazuje sa iba raz; ak ho zatvoríte bez skopírovania, budete musieť vytvoriť nového agenta.

2a. Variant A - systemd služba (Linux)

Pre Raspberry Pi, mini PC, virtuálny server alebo akýkoľvek Linux stroj s root prístupom:

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

Skript:

Nainštaluje Python 3 a binárku ping (ak chýbajú).
Stiahne agent.py do /opt/epulzio-agent.
Zapíše token do /opt/epulzio-agent/agent.env s permissions 0600.
Registruje a spúšťa systemd službu epulzio-agent.service.

Logy po inštalácii: journalctl -u epulzio-agent -f

2b. Variant B - Docker

Pre Synology / Unraid / k3s / TrueNAS / akýkoľvek Docker host:

[Docker image v príprave]

--network host je kľúčové: agent potrebuje pristupovať k lokálnej sieti hostiteľa, nie iba k Docker vnútornej sieti.

Kde najlepšie spustiť agenta: Stroj, ktorý je vždy zapnutý a má dobré sieťové pripojenie k zariadeniam, ktoré chcete monitorovať. Klasické voľby: Raspberry Pi v sieti, mini PC v rack-u, hypervisor host, NAS. Jeden agent zvládne stovky monitorov.

3. Overte v dashboarde

V LAN agenti sa vedľa agenta zobrazí status:

● online - agent posiela heartbeat (kontakt mladší než 2 minúty)
časová značka - kontakt v posledných 10 minútach
offline od … - kontakt starší než 10 minút (dostanete e-mail po 5 min)

Aktualizácia agenta

Pre systemd variant:

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

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


  Ďalší krok:
  Vytvorenie prvého LAN monitora (ping, TCP, HTTP).
  Prvý LAN monitor →