Quick start tutorial

Enrol your first endpoint, explore the dashboard, and run your first remote action — all in under 15 minutes.

Overview

This tutorial assumes you have already completed the Installation guide and First login & initial setup. By the end, you will have a live endpoint reporting into Xcellerate RMM and you will have executed a remote command on it.

You can follow this tutorial with any device you have access to — a workstation, a virtual machine, or even the server itself.

Key concepts

Enrolment token — a short-lived code that binds an agent to a specific tenant. Generated in the web UI.
Agent installer — a platform-specific package (MSI for Windows, PKG for macOS, DEB/RPM for Linux) that installs and starts the agent service.
Remote shell — an interactive terminal session on the endpoint, accessible from the Xcellerate web UI.

Step-by-step walkthrough

Generate an enrolment token

Go to Endpoints → Enrol new. Select the target tenant and operating system. Click Generate token. Copy the one-line install command.

Install the agent

On the target device, open a terminal (or PowerShell on Windows) and paste the install command. The script downloads the agent package, installs it, and registers the device with your server. Installation takes about 30 seconds.

Verify the endpoint appears

Switch back to the Xcellerate dashboard. Within 60 seconds, the new endpoint should appear in the Endpoints list with a green "online" status.

Explore the endpoint details

Click the endpoint name to view its detail page: hardware specs, installed software, OS version, network adapters, uptime, and recent events.

Run a remote command

From the endpoint detail page, click Remote shell. Type a simple command — e.g. hostname on any OS or Get-ComputerInfo on Windows. You should see the output instantly.

An enrolled endpoint showing hardware details and online status

Example: Windows agent install command

# Run in an elevated PowerShell prompt
Invoke-Expression ((New-Object System.Net.WebClient).DownloadString(
  "https://rmm.yourcompany.com/install?token=abc123"))

Example: Linux agent install command

# Run as root or with sudo
curl -sL https://rmm.yourcompany.com/install.sh?token=abc123 | sudo bash

Tips & best practices

Enrolment tokens expire after 24 hours by default. Generate a new one if the install script reports an invalid token.
For mass deployment, use Group Policy (Windows), Jamf (macOS), or a configuration management tool (Ansible, Puppet) to distribute the install command.
After enrolment, assign the endpoint to a group to automatically apply the right policies.
Try the AppDeploy feature next — push a common app (e.g. 7-Zip or Google Chrome) to your new endpoint with a single click.

Bookmark the Quick actions menu on the endpoint detail page. It gives you one-click access to restart, shutdown, wake-on-LAN, and collect a diagnostic bundle.

First login & initial setup

Groups