Instalace agenta (systemd / Docker)

4 min čtení · LAN agenti (interní síť)

Ve zkratce: Instalace LAN agenta trvá tři minuty. Buď jako systemd služba (Linux + root), nebo jako Docker kontejner (Synology, Unraid, k3s). Agent potřebuje pouze odchozí HTTPS na epulz.io.

1. Vytvořte agenta v dashboardu

Otevřete Dashboard → LAN agenti.
Zadejte rozumný název (např. „Firma X - serverovna", „Pi v prodejně Praha").
Stiskněte Vytvořit agenta.
Zobrazí se token ve formátu plzag_… - zkopírujte ho ihned. Zobrazuje se pouze jednou; pokud ho zavřete bez zkopírování, budete muset vytvořit nového agenta.

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

Pro Raspberry Pi, mini PC, virtuální server nebo jakýkoliv Linux stroj s root přístupem:

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

Skript:

Nainstaluje Python 3 a binárku ping (pokud chybí).
Stáhne agent.py do /opt/epulzio-agent.
Zapíše token do /opt/epulzio-agent/agent.env s permissions 0600.
Registruje a spouští systemd službu epulzio-agent.service.

Logy po instalaci: journalctl -u epulzio-agent -f

2b. Varianta B - Docker

Pro Synology / Unraid / k3s / TrueNAS / jakýkoliv Docker host:

[Docker image v príprave]

--network host je klíčové: agent potřebuje přistupovat k lokální síti hostitele, ne pouze k Docker vnitřní síti.

Kde nejlépe spustit agenta: Stroj, který je vždy zapnutý a má dobré síťové připojení k zařízením, která chcete monitorovat. Klasické volby: Raspberry Pi v síti, mini PC v racku, hypervisor host, NAS. Jeden agent zvládne stovky monitorů.

3. Ověřte v dashboardu

V LAN agenti se vedle agenta zobrazí status:

● online - agent posílá heartbeat (kontakt mladší než 2 minuty)
časová značka - kontakt v posledních 10 minutách
offline od … - kontakt starší než 10 minut (dostanete e-mail po 5 min)

Aktualizace agenta

Pro systemd variantu:

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

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


  Další krok:
  Vytvoření prvního LAN monitoru (ping, TCP, HTTP).
  První LAN monitor →