Skip to content

Getting Started

Your Name edited this page Jul 18, 2026 · 1 revision

Getting Started

The pieces

Part What it is
Server A self-hosted service with the web dashboard. It stores devices, policies and metrics, and keeps a live WebSocket connection to every agent.
Agent A small program on each managed device. It reports inventory + metrics on a heartbeat, and carries out actions (scripts, remote control, wake, notify, self-update). Runs as a service/SYSTEM.
Tray (Windows) A per-user companion that shows connection status and displays desktop notifications the agent can't show itself (the agent runs as SYSTEM).
Node Any agent you promote to a node. A node does local network discovery, SNMP polling, and relays Wake-on-LAN magic packets on its LAN.

How devices connect

  1. You install the agent on a device (see Installing the Agent).
  2. The agent connects outbound to the server over a secure WebSocket and enrolls.
  3. The new device lands in the approval queue — approve it and it starts reporting.
  4. From then on it appears on the dashboard with live CPU/memory/disk, inventory, and whatever policies apply.

There are no inbound ports to open on the device: the agent always dials out to the server.

Organisations, groups & devices

  • Organisations separate tenants/customers. Each has its own devices, policies and users.
  • Groups (e.g. by OS) let you scope policies to a subset of devices.
  • Policies can be global (all organisations), per-organisation, per-group, or per-device.

Next steps

Clone this wiki locally