Help & guides › LAN agents (internal network) › Agent installation (systemd / Docker)

Agent installation (systemd / Docker)

4 min read · LAN agents (internal network)

In short: Installation of a LAN agent takes three minutes. Either as a systemd service (Linux + root), or as a Docker container (Synology, Unraid, k3s). The agent only needs outbound HTTPS to epulz.io.

1. Create an agent in the dashboard

  1. Open Dashboard, LAN agents.
  2. Enter a reasonable name (e.g. "Company X - server room", "Pi in Bratislava shop").
  3. Press Create agent.
  4. A token in the format plzag_... is shown - copy it immediately. It is shown only once; if you close it without copying, you will have to create a new agent.

2a. Variant A - systemd service (Linux)

For a Raspberry Pi, mini PC, virtual server or any Linux machine with root access:

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

The script:

  • Installs Python 3 and the ping binary (if missing).
  • Downloads agent.py to /opt/epulzio-agent.
  • Writes the token to /opt/epulzio-agent/agent.env with permissions 0600.
  • Registers and starts the systemd service epulzio-agent.service.

Logs after installation: journalctl -u epulzio-agent -f

2b. Variant B - Docker

For Synology / Unraid / k3s / TrueNAS / any Docker host:

[Docker image v príprave]

--network host is key: the agent needs to access the host's local network, not only the Docker internal network.

Where best to run the agent: A machine that is always on and has a good network connection to the devices you want to monitor. Classic choices: a Raspberry Pi in the network, a mini PC in a rack, a hypervisor host, a NAS. One agent can handle hundreds of monitors.

3. Verify in the dashboard

In LAN agents the status is shown next to the agent:

  • online - the agent is sending a heartbeat (contact younger than 2 minutes)
  • timestamp - contact in the last 10 minutes
  • offline since ... - contact older than 10 minutes (you get an e-mail after 5 min)

Updating the agent

For the systemd variant:

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

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

Next step:

Creating the first LAN monitor (ping, TCP, HTTP).

First LAN monitor ->
Next →
Create first LAN monitor