Help en handleidingen › LAN agents (intern netwerk) › Agent installatie (systemd / Docker)

Agent installatie (systemd / Docker)

4 min leestijd · LAN agents (intern netwerk)

Kort gezegd: De installatie van de LAN agent duurt drie minuten. Hetzij als systemd service (Linux + root), hetzij als Docker container (Synology, Unraid, k3s). De agent heeft alleen uitgaande HTTPS naar epulz.io nodig.

1. Maak een agent aan in het dashboard

  1. Open Dashboard → LAN agents.
  2. Voer een redelijke naam in (bijv. "Bedrijf X - serverruimte", "Pi in winkel Amsterdam").
  3. Klik op Agent aanmaken.
  4. Een token in het formaat plzag_… wordt getoond - kopieer het direct. Het wordt slechts eenmaal getoond; als u het sluit zonder te kopiëren, moet u een nieuwe agent aanmaken.

2a. Variant A - systemd service (Linux)

Voor Raspberry Pi, mini PC, virtuele server of welke Linux machine met root toegang dan ook:

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

Het script:

  • Installeert Python 3 en het binair ping (indien ontbrekend).
  • Downloadt agent.py naar /opt/epulzio-agent.
  • Schrijft het token in /opt/epulzio-agent/agent.env met permissies 0600.
  • Registreert en start de systemd service epulzio-agent.service.

Logs na de installatie: journalctl -u epulzio-agent -f

2b. Variant B - Docker

Voor Synology / Unraid / k3s / TrueNAS / welke Docker host dan ook:

[Docker image v príprave]

--network host is essentieel: de agent moet toegang hebben tot het lokale netwerk van de host, niet alleen tot het Docker interne netwerk.

Waar de agent het beste te starten: Een machine die altijd aan staat en een goede netwerkverbinding heeft met de apparaten die u wilt monitoren. Klassieke keuzes: Raspberry Pi in het netwerk, mini PC in het rack, hypervisor host, NAS. Eén agent verwerkt honderden monitoren.

3. Controleer in het dashboard

In LAN agents wordt naast de agent de status getoond:

  • online - de agent stuurt heartbeat (contact jonger dan 2 minuten)
  • tijdstempel - contact in de laatste 10 minuten
  • offline sinds ... - contact ouder dan 10 minuten (u ontvangt een e-mail na 5 min)

Update van de agent

Voor de systemd variant:

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

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

Volgende stap:

Een eerste LAN monitor aanmaken (ping, TCP, HTTP).

Eerste LAN monitor →
Volgende →
Eerste LAN monitor maken