Managing Agents

Monitor endpoint health, run commands remotely, and manage your agent fleet from the dashboard.

Agent List

The Agents page shows all enrolled endpoints with key information:

  • Hostname — Computer name
  • Status — Online, degraded, or offline
  • OS Version — e.g., Windows 11 Pro 23H2
  • Agent Version — Currently installed agent version
  • CPU / RAM — Hardware specs and current utilization
  • AV Status — Antivirus detection and status (e.g., "Windows Defender — Up to date")
  • WAN IP — Public IP address of the endpoint
  • Last Seen — Timestamp of the most recent telemetry report
  • Last User — Currently or most recently logged-in user
  • Pending Reboot — Whether the machine requires a restart
  • Patch Compliance — Compliant or non-compliant status

Agent Detail Panel

Click any agent in the list to open the detail panel. This provides deep visibility into the endpoint:

Overview Tab

  • Full hardware inventory: manufacturer, model, serial number, CPU model and cores, total RAM
  • Software inventory: all installed applications with versions
  • Winget status for application management
  • RustDesk remote access status (installed and running)

Telemetry Tab

Real-time and historical charts for:

  • CPU usage over time
  • RAM utilization
  • Disk usage per volume
  • Uptime
  • AV status changes

Use the time range selector to view the last 1, 6, 12, 24, or 48 hours of telemetry data.

Alerts Tab

Lists all unresolved alerts for this specific agent. You can acknowledge or resolve alerts directly from here.

Security Tab

Shows the security score for this agent, including individual check results and compliance framework mappings.

Remote Commands

Send commands to an online agent from the dashboard. Navigate to the agent detail and click Commands:

Command Description
Force Update Download and install the latest agent version
Restart Agent Restart the MaxRMM Agent service
Patch Scan Trigger an immediate Windows Update scan
Patch Install Install all approved pending patches
Reboot Restart the endpoint (with configurable delay)

Every command is sent via the secure WebSocket connection and logged in the audit trail with the technician who initiated it.

Remote Terminal

The Terminal tab opens a live PowerShell session on the remote agent. This allows you to run any command as if you were sitting at the machine.

Security note: Terminal sessions run with SYSTEM privileges. All commands are logged in the audit trail. Use with care.

Remote Connect (RustDesk)

If RustDesk is installed on the endpoint, you can initiate a remote desktop session directly from the dashboard. The agent detail shows:

  • RustDesk Installed — whether the RustDesk client is present
  • RustDesk Running — whether the service is active

Click Remote Connect to launch a session.

Provisioning New Agents

In addition to the install key flow, administrators can pre-provision agents from the API:

POST /api/agents
Content-Type: application/json
Authorization: Bearer <access-token>

{
  "hostname": "WORKSTATION-42"
}

This creates an agent record and returns a one-time token that the agent binary uses to authenticate. See API Endpoints for details.