diff --git a/lib/towerops_web/live/help_live/index.ex b/lib/towerops_web/live/help_live/index.ex index e7386408..8c2c7b20 100644 --- a/lib/towerops_web/live/help_live/index.ex +++ b/lib/towerops_web/live/help_live/index.ex @@ -821,9 +821,12 @@ defmodule ToweropsWeb.HelpLive.Index do
- Remote pollers allow you to monitor devices that are not accessible from the public internet, - such as devices behind firewalls, in private networks, or at remote locations. A remote poller - runs on your network and securely communicates with Towerops to poll your devices locally. + Remote pollers are lightweight Docker containers that run on your network to monitor devices + that aren't accessible from the public internet — behind firewalls, on private networks, or + at remote locations. They use minimal resources (1 CPU core, 512 MB RAM) and auto-update + themselves via Watchtower. Just deploy a + <.code>docker-compose.yml + and you're done.
- On the Agents page, add a new remote agent. Copy the + When you create a new agent on the + <.code>Agents + page, Towerops will show you a ready-to-use <.code>docker-compose.yml - file contents from the agent details, which includes your authentication token pre-configured. + with your agent token pre-filled. It looks like this: +
+services:
+ towerops-agent:
+ image: ghcr.io/towerops-app/towerops-agent:latest
+ container_name: towerops-agent
+ restart: unless-stopped
+ environment:
+ - TOWEROPS_API_URL=https://app.towerops.net/
+ - TOWEROPS_AGENT_TOKEN=your-token-here
+ labels:
+ - "com.centurylinklabs.watchtower.enable=true"
+ - "com.centurylinklabs.watchtower.scope=towerops"
+
+ watchtower:
+ image: containrrr/watchtower:latest
+ container_name: towerops-watchtower
+ restart: unless-stopped
+ environment:
+ - WATCHTOWER_POLL_INTERVAL=43200
+ - WATCHTOWER_LABEL_ENABLE=true
+ - WATCHTOWER_CLEANUP=true
+ volumes:
+ - /var/run/docker.sock:/var/run/docker.sock
+ + The agent is lightweight — it uses minimal CPU and memory. Watchtower is included + to automatically update the agent every 12 hours, so you never have to think about it.
- Transfer the + Copy the <.code>docker-compose.yml - file to your server and run: + to your server and run:
docker compose up -d
- The remote poller will start automatically and connect to Towerops. + That's it. The agent will connect to Towerops within seconds and start polling your local devices. + You'll see it come online on the Agents page.